<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=11"/>
<meta name="generator" content="Doxygen 1.9.4"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<title>Flow-IPC: session/detail/server_session_impl.hpp Source File</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="search/searchdata.js"></script>
<script type="text/javascript" src="search/search.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
 <tbody>
 <tr id="projectrow">
  <td id="projectalign">
   <div id="projectname">Flow-IPC<span id="projectnumber">&#160;1.0.2</span>
   </div>
   <div id="projectbrief">Flow-IPC project: Full implementation reference.</div>
  </td>
 </tr>
 </tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.9.4 -->
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
var searchBox = new SearchBox("searchBox", "search",'Search','.html');
/* @license-end */
</script>
<script type="text/javascript" src="menudata.js"></script>
<script type="text/javascript" src="menu.js"></script>
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
$(function() {
  initMenu('',true,false,'search.php','Search');
  $(document).ready(function() { init_search(); });
});
/* @license-end */
</script>
<div id="main-nav"></div>
<!-- window showing the filter options -->
<div id="MSearchSelectWindow"
     onmouseover="return searchBox.OnSearchSelectShow()"
     onmouseout="return searchBox.OnSearchSelectHide()"
     onkeydown="return searchBox.OnSearchSelectKey(event)">
</div>

<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<iframe src="javascript:void(0)" frameborder="0" 
        name="MSearchResults" id="MSearchResults">
</iframe>
</div>

<div id="nav-path" class="navpath">
  <ul>
<li class="navelem"><a class="el" href="dir_938858dd290fe54e59e3500689c41d32.html">session</a></li><li class="navelem"><a class="el" href="dir_b920fd4362476866a1b4325a80ed2bf5.html">detail</a></li>  </ul>
</div>
</div><!-- top -->
<div class="header">
  <div class="headertitle"><div class="title">server_session_impl.hpp</div></div>
</div><!--header-->
<div class="contents">
<a href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp.html">Go to the documentation of this file.</a><div class="fragment"><div class="line"><a id="l00001" name="l00001"></a><span class="lineno">    1</span><span class="comment">/* Flow-IPC: Sessions</span></div>
<div class="line"><a id="l00002" name="l00002"></a><span class="lineno">    2</span><span class="comment"> * Copyright 2023 Akamai Technologies, Inc.</span></div>
<div class="line"><a id="l00003" name="l00003"></a><span class="lineno">    3</span><span class="comment"> *</span></div>
<div class="line"><a id="l00004" name="l00004"></a><span class="lineno">    4</span><span class="comment"> * Licensed under the Apache License, Version 2.0 (the</span></div>
<div class="line"><a id="l00005" name="l00005"></a><span class="lineno">    5</span><span class="comment"> * &quot;License&quot;); you may not use this file except in</span></div>
<div class="line"><a id="l00006" name="l00006"></a><span class="lineno">    6</span><span class="comment"> * compliance with the License.  You may obtain a copy</span></div>
<div class="line"><a id="l00007" name="l00007"></a><span class="lineno">    7</span><span class="comment"> * of the License at</span></div>
<div class="line"><a id="l00008" name="l00008"></a><span class="lineno">    8</span><span class="comment"> *</span></div>
<div class="line"><a id="l00009" name="l00009"></a><span class="lineno">    9</span><span class="comment"> *   https://www.apache.org/licenses/LICENSE-2.0</span></div>
<div class="line"><a id="l00010" name="l00010"></a><span class="lineno">   10</span><span class="comment"> *</span></div>
<div class="line"><a id="l00011" name="l00011"></a><span class="lineno">   11</span><span class="comment"> * Unless required by applicable law or agreed to in</span></div>
<div class="line"><a id="l00012" name="l00012"></a><span class="lineno">   12</span><span class="comment"> * writing, software distributed under the License is</span></div>
<div class="line"><a id="l00013" name="l00013"></a><span class="lineno">   13</span><span class="comment"> * distributed on an &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR</span></div>
<div class="line"><a id="l00014" name="l00014"></a><span class="lineno">   14</span><span class="comment"> * CONDITIONS OF ANY KIND, either express or implied.</span></div>
<div class="line"><a id="l00015" name="l00015"></a><span class="lineno">   15</span><span class="comment"> * See the License for the specific language governing</span></div>
<div class="line"><a id="l00016" name="l00016"></a><span class="lineno">   16</span><span class="comment"> * permissions and limitations under the License. */</span></div>
<div class="line"><a id="l00017" name="l00017"></a><span class="lineno">   17</span><span class="comment"></span> </div>
<div class="line"><a id="l00018" name="l00018"></a><span class="lineno">   18</span><span class="comment">/// @file</span></div>
<div class="line"><a id="l00019" name="l00019"></a><span class="lineno">   19</span><span class="comment"></span><span class="preprocessor">#pragma once</span></div>
<div class="line"><a id="l00020" name="l00020"></a><span class="lineno">   20</span> </div>
<div class="line"><a id="l00021" name="l00021"></a><span class="lineno">   21</span><span class="preprocessor">#include &quot;<a class="code" href="session__base_8hpp.html">ipc/session/detail/session_base.hpp</a>&quot;</span></div>
<div class="line"><a id="l00022" name="l00022"></a><span class="lineno">   22</span><span class="preprocessor">#include &quot;<a class="code" href="ipc__session_2src_2ipc_2session_2error_8hpp.html">ipc/session/error.hpp</a>&quot;</span></div>
<div class="line"><a id="l00023" name="l00023"></a><span class="lineno">   23</span><span class="preprocessor">#include &quot;<a class="code" href="protocol__negotiator_8hpp.html">ipc/transport/protocol_negotiator.hpp</a>&quot;</span></div>
<div class="line"><a id="l00024" name="l00024"></a><span class="lineno">   24</span> </div>
<div class="line"><a id="l00025" name="l00025"></a><span class="lineno">   25</span><span class="keyword">namespace </span><a class="code hl_namespace" href="namespaceipc_1_1session.html">ipc::session</a></div>
<div class="line"><a id="l00026" name="l00026"></a><span class="lineno">   26</span>{</div>
<div class="line"><a id="l00027" name="l00027"></a><span class="lineno">   27</span> </div>
<div class="line"><a id="l00028" name="l00028"></a><span class="lineno">   28</span><span class="comment">// Types.</span></div>
<div class="line"><a id="l00029" name="l00029"></a><span class="lineno">   29</span><span class="comment"></span> </div>
<div class="line"><a id="l00030" name="l00030"></a><span class="lineno">   30</span><span class="comment">/**</span></div>
<div class="line"><a id="l00031" name="l00031"></a><span class="lineno">   31</span><span class="comment"> * Internal, non-movable pImpl-lite implementation of Server_session_mv class template.</span></div>
<div class="line"><a id="l00032" name="l00032"></a><span class="lineno">   32</span><span class="comment"> * In and of itself it would have been directly and publicly usable; however Server_session_mv adds move semantics.</span></div>
<div class="line"><a id="l00033" name="l00033"></a><span class="lineno">   33</span><span class="comment"> *</span></div>
<div class="line"><a id="l00034" name="l00034"></a><span class="lineno">   34</span><span class="comment"> * @see All discussion of the public (and `protected`, to be exposed `public`ly by Server_session_dtl) API is in</span></div>
<div class="line"><a id="l00035" name="l00035"></a><span class="lineno">   35</span><span class="comment"> *      Server_session_mv doc header; that class template forwards to this</span></div>
<div class="line"><a id="l00036" name="l00036"></a><span class="lineno">   36</span><span class="comment"> *      one.  All discussion of pImpl-lite-related notions is also there.  See that doc header first please.  Then come</span></div>
<div class="line"><a id="l00037" name="l00037"></a><span class="lineno">   37</span><span class="comment"> *      back here.</span></div>
<div class="line"><a id="l00038" name="l00038"></a><span class="lineno">   38</span><span class="comment"> *</span></div>
<div class="line"><a id="l00039" name="l00039"></a><span class="lineno">   39</span><span class="comment"> * Impl design</span></div>
<div class="line"><a id="l00040" name="l00040"></a><span class="lineno">   40</span><span class="comment"> * -----------</span></div>
<div class="line"><a id="l00041" name="l00041"></a><span class="lineno">   41</span><span class="comment"> * Generally, I (ygoldfel) recommend looking through and understanding Client_session_impl first.  It is similar but</span></div>
<div class="line"><a id="l00042" name="l00042"></a><span class="lineno">   42</span><span class="comment"> * somewhat more complex, and once it is understood, you&#39;ll be able to understand Server_session_impl easily.  Plus</span></div>
<div class="line"><a id="l00043" name="l00043"></a><span class="lineno">   43</span><span class="comment"> * its logic is complementary to a `*this`, as the two directly interoperate via a couple of IPC forms.  The below</span></div>
<div class="line"><a id="l00044" name="l00044"></a><span class="lineno">   44</span><span class="comment"> * discussion does assume one has read/understood Client_session_impl doc header.</span></div>
<div class="line"><a id="l00045" name="l00045"></a><span class="lineno">   45</span><span class="comment"> *</span></div>
<div class="line"><a id="l00046" name="l00046"></a><span class="lineno">   46</span><span class="comment"> * Thread U represents all threads other than thread W: since the relevant methods are to be called by the user</span></div>
<div class="line"><a id="l00047" name="l00047"></a><span class="lineno">   47</span><span class="comment"> * sans concurrency, those threads as a collection can be thought of as one thread.</span></div>
<div class="line"><a id="l00048" name="l00048"></a><span class="lineno">   48</span><span class="comment"> *</span></div>
<div class="line"><a id="l00049" name="l00049"></a><span class="lineno">   49</span><span class="comment"> * Thread W is the async worker thread where most work is done; this helps us entirely avoid mutexes.</span></div>
<div class="line"><a id="l00050" name="l00050"></a><span class="lineno">   50</span><span class="comment"> * async_accept_log_in() is called exactly once, internally by Session_server; and subsequently</span></div>
<div class="line"><a id="l00051" name="l00051"></a><span class="lineno">   51</span><span class="comment"> * open_channel() is fairly infrequently called.  So it&#39;s not necessary to avoid</span></div>
<div class="line"><a id="l00052" name="l00052"></a><span class="lineno">   52</span><span class="comment"> * latency by doing work concurrently in threads U and W.  So we keep it simple by posting most stuff onto thread W.</span></div>
<div class="line"><a id="l00053" name="l00053"></a><span class="lineno">   53</span><span class="comment"> *</span></div>
<div class="line"><a id="l00054" name="l00054"></a><span class="lineno">   54</span><span class="comment"> * The state machine of Server_session_impl is simpler than Client_session_impl.  The asymmetry is, firstly, due to the</span></div>
<div class="line"><a id="l00055" name="l00055"></a><span class="lineno">   55</span><span class="comment"> * client-server setup: Session_server is the one, on the server end, that awaits the initial</span></div>
<div class="line"><a id="l00056" name="l00056"></a><span class="lineno">   56</span><span class="comment"> * transport::Native_socket_stream connection.  Once a PEER-state `Native_socket_stream` is ready, only then</span></div>
<div class="line"><a id="l00057" name="l00057"></a><span class="lineno">   57</span><span class="comment"> * does Session_server create a Server_session_dtl (which is a `public` facade to Server_session_mv, which</span></div>
<div class="line"><a id="l00058" name="l00058"></a><span class="lineno">   58</span><span class="comment"> * is a movable `unique_ptr` wrapper around this Server_session_impl).  So `*this`, unlike a Client_session_impl,</span></div>
<div class="line"><a id="l00059" name="l00059"></a><span class="lineno">   59</span><span class="comment"> * does not need to connect a socket.  Next, Server_session_impl just needs to complete one async step, which is</span></div>
<div class="line"><a id="l00060" name="l00060"></a><span class="lineno">   60</span><span class="comment"> * in practice immediately (and, by contract, only once) invoked: async_accept_log_in().  At this stage user does</span></div>
<div class="line"><a id="l00061" name="l00061"></a><span class="lineno">   61</span><span class="comment"> * not have the Server_session_mv yet, so we&#39;re still in internal-code land.  (By contrast Client_session is</span></div>
<div class="line"><a id="l00062" name="l00062"></a><span class="lineno">   62</span><span class="comment"> * created directly by the user and is immediately publicly available as a stand-alone object.)  async_accept_log_in()</span></div>
<div class="line"><a id="l00063" name="l00063"></a><span class="lineno">   63</span><span class="comment"> * immediately upgrades the `Native_socket_stream` to a transport::Channel and then immediately upgrades that</span></div>
<div class="line"><a id="l00064" name="l00064"></a><span class="lineno">   64</span><span class="comment"> * to a transport::struc::Channel, saving it to #m_master_channel (all synchronously).  Lastly is the actual async work:</span></div>
<div class="line"><a id="l00065" name="l00065"></a><span class="lineno">   65</span><span class="comment"> * awaiting the log-in request from Client_session.  Once that is received, we respond via #m_master_channel,</span></div>
<div class="line"><a id="l00066" name="l00066"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#a88b5e68821f26cfab86feb8b4dc5702a">   66</a></span><span class="comment"> * either with log-in success or failure.  Assuming success, we invoke the (internal) async_accept_log_in()</span></div>
<div class="line"><a id="l00067" name="l00067"></a><span class="lineno">   67</span><span class="comment"> * handler; on failure same thing but with a failure #Error_code.</span></div>
<div class="line"><a id="l00068" name="l00068"></a><span class="lineno">   68</span><span class="comment"> *</span></div>
<div class="line"><a id="l00069" name="l00069"></a><span class="lineno">   69</span><span class="comment"> * ### Sidebar: Init-channels ###</span></div>
<div class="line"><a id="l00070" name="l00070"></a><span class="lineno">   70</span><span class="comment"> * Update (init-channels feature has been added): The preceding paragraph holds fully if and only if:</span></div>
<div class="line"><a id="l00071" name="l00071"></a><span class="lineno">   71</span><span class="comment"> *   - client (in its log-in request message, `LogInReq`) requested 0 init-channels to be opened on its behalf; and</span></div>
<div class="line"><a id="l00072" name="l00072"></a><span class="lineno">   72</span><span class="comment"> *   - server (via the user args from Session_server::async_accept() forwarded to async_accept_log_in()) requested</span></div>
<div class="line"><a id="l00073" name="l00073"></a><span class="lineno">   73</span><span class="comment"> *     0 init-channels to be opened on local user&#39;s behalf.</span></div>
<div class="line"><a id="l00074" name="l00074"></a><span class="lineno">   74</span><span class="comment"> *</span></div>
<div class="line"><a id="l00075" name="l00075"></a><span class="lineno">   75</span><span class="comment"> * However, if the sum of these 2 numbers (as determined upon successful receipt on `LogInReq`, and assuming</span></div>
<div class="line"><a id="l00076" name="l00076"></a><span class="lineno">   76</span><span class="comment"> * everything else was also successful, up-to-and-including sending successful `LogInRsp`) is N=1+, then before</span></div>
<div class="line"><a id="l00077" name="l00077"></a><span class="lineno">   77</span><span class="comment"> * async_accept_log_in() can reach almost-PEER state (and fire completion handler), there is 1 more async-step:</span></div>
<div class="line"><a id="l00078" name="l00078"></a><span class="lineno">   78</span><span class="comment"> *   - (send `LogInRsp` as explained);</span></div>
<div class="line"><a id="l00079" name="l00079"></a><span class="lineno">   79</span><span class="comment"> *   - (prep) synchronously prepare the N=1+ init-channels (exactly as would occur</span></div>
<div class="line"><a id="l00080" name="l00080"></a><span class="lineno">   80</span><span class="comment"> *     if user invoked open_channel() N times in PEER state);</span></div>
<div class="line"><a id="l00081" name="l00081"></a><span class="lineno">   81</span><span class="comment"> *   - (prep) sync-send N `OpenChannelToClientReq` messages with names/handles for each of the N init-channels</span></div>
<div class="line"><a id="l00082" name="l00082"></a><span class="lineno">   82</span><span class="comment"> *     (exactly as would occur on N open_channel() calls in PEER state);</span></div>
<div class="line"><a id="l00083" name="l00083"></a><span class="lineno">   83</span><span class="comment"> *   - async: await a *single* `OpenChannelToClientRsp` response, indicating the last of the N channels has been</span></div>
<div class="line"><a id="l00084" name="l00084"></a><span class="lineno">   84</span><span class="comment"> *     accepted, and client is now in PEER state and ready for passive-opens (i.e., we can enter PEER-state</span></div>
<div class="line"><a id="l00085" name="l00085"></a><span class="lineno">   85</span><span class="comment"> *     which enabled open_channel() by the local user).</span></div>
<div class="line"><a id="l00086" name="l00086"></a><span class="lineno">   86</span><span class="comment"> *</span></div>
<div class="line"><a id="l00087" name="l00087"></a><span class="lineno">   87</span><span class="comment"> * Why this last async step?  Couldn&#39;t we just do the `send()`s and go to almost-PEER state immediately?</span></div>
<div class="line"><a id="l00088" name="l00088"></a><span class="lineno">   88</span><span class="comment"> * Almost: but if we did that, then if the user immediately issued init_handlers() and an open_channel(),</span></div>
<div class="line"><a id="l00089" name="l00089"></a><span class="lineno">   89</span><span class="comment"> * then the opposing Client_session_impl might not, technically, be quick enough to have moved to its own PEER state;</span></div>
<div class="line"><a id="l00090" name="l00090"></a><span class="lineno">   90</span><span class="comment"> * then its `OpenChannelToClientReq` handler from the pre-PEER state (CONNECTING state) might be triggered;</span></div>
<div class="line"><a id="l00091" name="l00091"></a><span class="lineno">   91</span><span class="comment"> * this would cause... nothing good.  However the ACK from Client_session_impl is sent only just before</span></div>
<div class="line"><a id="l00092" name="l00092"></a><span class="lineno">   92</span><span class="comment"> * entering PEER state, at which point it is safe for us to issue open_channel()s.</span></div>
<div class="line"><a id="l00093" name="l00093"></a><span class="lineno">   93</span><span class="comment"> *</span></div>
<div class="line"><a id="l00094" name="l00094"></a><span class="lineno">   94</span><span class="comment"> * ### Back to general impl discussion ###</span></div>
<div class="line"><a id="l00095" name="l00095"></a><span class="lineno">   95</span><span class="comment"> * Our async_accept_log_in() is analogous/complementary to Client_session_impl::async_connect(), but the diff is that</span></div>
<div class="line"><a id="l00096" name="l00096"></a><span class="lineno">   96</span><span class="comment"> * the user only gets access to a `*this` upon success of this async op; and never gets access upon failure</span></div>
<div class="line"><a id="l00097" name="l00097"></a><span class="lineno">   97</span><span class="comment"> * at all.  So that&#39;s another source of asymmetry versus Client_session_impl.  Thus:</span></div>
<div class="line"><a id="l00098" name="l00098"></a><span class="lineno">   98</span><span class="comment"> *   - No need to guard against async_accept_log_in() call while the log-in is outstanding.</span></div>
<div class="line"><a id="l00099" name="l00099"></a><span class="lineno">   99</span><span class="comment"> *     - (As of *this* writing Client_session_impl only uses async_connect() internally and does not expose it,</span></div>
<div class="line"><a id="l00100" name="l00100"></a><span class="lineno">  100</span><span class="comment"> *       so it&#39;s not an issue there either; but that would change, if it became network-enabled at some level.)</span></div>
<div class="line"><a id="l00101" name="l00101"></a><span class="lineno">  101</span><span class="comment"> *   - No need to guard against other API calls, notably open_channel(), before (almost-)PEER state is achieved.</span></div>
<div class="line"><a id="l00102" name="l00102"></a><span class="lineno">  102</span><span class="comment"> *     (User only gets access to `*this`, once `*this` is in (almost-)PEER state.)</span></div>
<div class="line"><a id="l00103" name="l00103"></a><span class="lineno">  103</span><span class="comment"> *</span></div>
<div class="line"><a id="l00104" name="l00104"></a><span class="lineno">  104</span><span class="comment"> * Therefore there&#39;s no need to track an `m_state` the way Client_session_impl does.  If #m_log_in_on_done_func</span></div>
<div class="line"><a id="l00105" name="l00105"></a><span class="lineno">  105</span><span class="comment"> * is non-empty, then async_accept_log_in() is outstanding (analogous to Client_session_impl CONNECTING state).</span></div>
<div class="line"><a id="l00106" name="l00106"></a><span class="lineno">  106</span><span class="comment"> * Otherwise see the &quot;almost-PEER&quot; section just below.</span></div>
<div class="line"><a id="l00107" name="l00107"></a><span class="lineno">  107</span><span class="comment"> *</span></div>
<div class="line"><a id="l00108" name="l00108"></a><span class="lineno">  108</span><span class="comment"> * ### Almost-PEER state impl ###</span></div>
<div class="line"><a id="l00109" name="l00109"></a><span class="lineno">  109</span><span class="comment"> * There is a minor wrinkle in Server_session_mv (and thus Server_session_impl).  Once the user obtains</span></div>
<div class="line"><a id="l00110" name="l00110"></a><span class="lineno">  110</span><span class="comment"> * the Server_session_mv, it is in the so-called *almost-PEER* state.  That is because it needs 1-2 more pieces of</span></div>
<div class="line"><a id="l00111" name="l00111"></a><span class="lineno">  111</span><span class="comment"> * info to be set before it is formally in PEER state as specified by Session concept.  Namely its</span></div>
<div class="line"><a id="l00112" name="l00112"></a><span class="lineno">  112</span><span class="comment"> * on-error handler must be set (mandatory), as must its on-passive-open handler (optional; in that leaving it</span></div>
<div class="line"><a id="l00113" name="l00113"></a><span class="lineno">  113</span><span class="comment"> * unspecified is allowed and means passive-opens are disabled on this side).  To do so the *user*</span></div>
<div class="line"><a id="l00114" name="l00114"></a><span class="lineno">  114</span><span class="comment"> * shall call init_handlers().  Until this is done, open_channel() and other public PEER-state APIs shall</span></div>
<div class="line"><a id="l00115" name="l00115"></a><span class="lineno">  115</span><span class="comment"> * no-op and return sentinel/`false`.</span></div>
<div class="line"><a id="l00116" name="l00116"></a><span class="lineno">  116</span><span class="comment"> *</span></div>
<div class="line"><a id="l00117" name="l00117"></a><span class="lineno">  117</span><span class="comment"> * There is a subtlety in how this are-handlers-set check is performed.  The crux of it is that #m_master_channel</span></div>
<div class="line"><a id="l00118" name="l00118"></a><span class="lineno">  118</span><span class="comment"> * can report an error at any time starting with async_accept_log_in() (where it is first created), and what to</span></div>
<div class="line"><a id="l00119" name="l00119"></a><span class="lineno">  119</span><span class="comment"> * do is quite different in each case:</span></div>
<div class="line"><a id="l00120" name="l00120"></a><span class="lineno">  120</span><span class="comment"> *   - Before public availability to user (async log-in ongoing).</span></div>
<div class="line"><a id="l00121" name="l00121"></a><span class="lineno">  121</span><span class="comment"> *     - Contingency: report failure of async_accept_log_in(), via its on-done handler.</span></div>
<div class="line"><a id="l00122" name="l00122"></a><span class="lineno">  122</span><span class="comment"> *   - After that but in almost-PEER state (on-error handler not yet set by user).</span></div>
<div class="line"><a id="l00123" name="l00123"></a><span class="lineno">  123</span><span class="comment"> *     - Contingency: well, we *want* to report it via on-error handler... but it&#39;s not set yet.</span></div>
<div class="line"><a id="l00124" name="l00124"></a><span class="lineno">  124</span><span class="comment"> *       So memorize it in special member #m_pre_init_err_code.  Then in init_handlers() immediately fire off</span></div>
<div class="line"><a id="l00125" name="l00125"></a><span class="lineno">  125</span><span class="comment"> *       the freshly-available on-error handler with that #Error_code.</span></div>
<div class="line"><a id="l00126" name="l00126"></a><span class="lineno">  126</span><span class="comment"> *   - In PEER state (the handler has been set).</span></div>
<div class="line"><a id="l00127" name="l00127"></a><span class="lineno">  127</span><span class="comment"> *     - Contingency: yay, forward the #m_master_channel-reported #Error_code to the on-error</span></div>
<div class="line"><a id="l00128" name="l00128"></a><span class="lineno">  128</span><span class="comment"> *       handler.</span></div>
<div class="line"><a id="l00129" name="l00129"></a><span class="lineno">  129</span><span class="comment"> *</span></div>
<div class="line"><a id="l00130" name="l00130"></a><span class="lineno">  130</span><span class="comment"> * Because the #m_master_channel error handler is relevant across all of the above, and it is executed in thread W</span></div>
<div class="line"><a id="l00131" name="l00131"></a><span class="lineno">  131</span><span class="comment"> * for reasons explained above (avoiding mutexes, etc.), to avoid concurrency difficulties the are-handlers-set</span></div>
<div class="line"><a id="l00132" name="l00132"></a><span class="lineno">  132</span><span class="comment"> * check, and the assignment of the handlers, is also done in thread W.  Hence, like most code in Server_session_impl,</span></div>
<div class="line"><a id="l00133" name="l00133"></a><span class="lineno">  133</span><span class="comment"> * init_handlers() posts all its work onto thread W.  All public APIs, even simple ones like session_token(),</span></div>
<div class="line"><a id="l00134" name="l00134"></a><span class="lineno">  134</span><span class="comment"> * do the same, and that thread-W work always begins by ensuring handlers_are_set().</span></div>
<div class="line"><a id="l00135" name="l00135"></a><span class="lineno">  135</span><span class="comment"> *</span></div>
<div class="line"><a id="l00136" name="l00136"></a><span class="lineno">  136</span><span class="comment"> * Once PEER state is achieved, to the user `*this` is (just like Client_session_impl) an impl of Session concept.</span></div>
<div class="line"><a id="l00137" name="l00137"></a><span class="lineno">  137</span><span class="comment"> * Internally it&#39;s somewhat different.</span></div>
<div class="line"><a id="l00138" name="l00138"></a><span class="lineno">  138</span><span class="comment"> *</span></div>
<div class="line"><a id="l00139" name="l00139"></a><span class="lineno">  139</span><span class="comment"> * ### PEER state impl ###</span></div>
<div class="line"><a id="l00140" name="l00140"></a><span class="lineno">  140</span><span class="comment"> * Here our algorithm is complementary to the PEER state algorithm in Client_session_impl.  Namely we expect</span></div>
<div class="line"><a id="l00141" name="l00141"></a><span class="lineno">  141</span><span class="comment"> * passive-opens via an appropriate transport::struc::Channel::expect_msgs(); and we allow active-opens via</span></div>
<div class="line"><a id="l00142" name="l00142"></a><span class="lineno">  142</span><span class="comment"> * open_channel(). The details of how these work is best understood just by reading that code inline.  All in</span></div>
<div class="line"><a id="l00143" name="l00143"></a><span class="lineno">  143</span><span class="comment"> * all, publicly it&#39;s just like Client_session_impl; but internally it is its complement and in fact has</span></div>
<div class="line"><a id="l00144" name="l00144"></a><span class="lineno">  144</span><span class="comment"> * different (complementary) responsibilities.  Most notably, regarding active-opens and passive-opens:</span></div>
<div class="line"><a id="l00145" name="l00145"></a><span class="lineno">  145</span><span class="comment"> *   - Server_session_impl is the one always internally responsible for acquiring the resources needed to</span></div>
<div class="line"><a id="l00146" name="l00146"></a><span class="lineno">  146</span><span class="comment"> *     establish the channel.  Namely:</span></div>
<div class="line"><a id="l00147" name="l00147"></a><span class="lineno">  147</span><span class="comment"> *     - If #S_MQS_ENABLED: it *creates* the underlying MQs.  This involves choosing a distinct-enough name for</span></div>
<div class="line"><a id="l00148" name="l00148"></a><span class="lineno">  148</span><span class="comment"> *       each of the 2 MQs (one in each direction, client-&gt;server, server-&gt;client).  These names shall be</span></div>
<div class="line"><a id="l00149" name="l00149"></a><span class="lineno">  149</span><span class="comment"> *       sent-over, via #m_master_channel, to the Client_session_impl.</span></div>
<div class="line"><a id="l00150" name="l00150"></a><span class="lineno">  150</span><span class="comment"> *     - If #S_SOCKET_STREAM_ENABLED: it *creates* the pre-connected socket-pair, 1/2 of which (a `Native_handle`)</span></div>
<div class="line"><a id="l00151" name="l00151"></a><span class="lineno">  151</span><span class="comment"> *       shall be sent-over, via #m_master_channel, to the Client_session_impl.</span></div>
<div class="line"><a id="l00152" name="l00152"></a><span class="lineno">  152</span><span class="comment"> *   - Hence:</span></div>
<div class="line"><a id="l00153" name="l00153"></a><span class="lineno">  153</span><span class="comment"> *     - An active-open (open_channel()) sends over the references/handles to the above resource(s) in the</span></div>
<div class="line"><a id="l00154" name="l00154"></a><span class="lineno">  154</span><span class="comment"> *       open-channel-to-client request out-message via #m_master_channel.  It then ensures the client</span></div>
<div class="line"><a id="l00155" name="l00155"></a><span class="lineno">  155</span><span class="comment"> *       replies with an OK (or failure) response in-message.  open_channel() thus succeeds or fails.</span></div>
<div class="line"><a id="l00156" name="l00156"></a><span class="lineno">  156</span><span class="comment"> *     - A passive-open (on_master_channel_open_channel_req()) involves receiving an</span></div>
<div class="line"><a id="l00157" name="l00157"></a><span class="lineno">  157</span><span class="comment"> *       open-channel-to-server request in-message via #m_master_channel.  It then acquires the above resource(s)</span></div>
<div class="line"><a id="l00158" name="l00158"></a><span class="lineno">  158</span><span class="comment"> *       and sends over the refs/handles to said resource(s) in our OK response to that request and invokes</span></div>
<div class="line"><a id="l00159" name="l00159"></a><span class="lineno">  159</span><span class="comment"> *       the on-passive-open handler locally.</span></div>
<div class="line"><a id="l00160" name="l00160"></a><span class="lineno">  160</span><span class="comment"> *</span></div>
<div class="line"><a id="l00161" name="l00161"></a><span class="lineno">  161</span><span class="comment"> * Client_session_impl active-opens and passive-opens act in a complementary fashion, never acquiring these resources</span></div>
<div class="line"><a id="l00162" name="l00162"></a><span class="lineno">  162</span><span class="comment"> * but knowing what to expect.</span></div>
<div class="line"><a id="l00163" name="l00163"></a><span class="lineno">  163</span><span class="comment"> *</span></div>
<div class="line"><a id="l00164" name="l00164"></a><span class="lineno">  164</span><span class="comment"> * Otherwise open_channel() is set up similarly to Client_session_impl::open_channel(), namely the</span></div>
<div class="line"><a id="l00165" name="l00165"></a><span class="lineno">  165</span><span class="comment"> * non-blocking/synchronous facade with async-with-timeout internals.  See Client_session_impl doc header for</span></div>
<div class="line"><a id="l00166" name="l00166"></a><span class="lineno">  166</span><span class="comment"> * brief discussion.</span></div>
<div class="line"><a id="l00167" name="l00167"></a><span class="lineno">  167</span><span class="comment"> *</span></div>
<div class="line"><a id="l00168" name="l00168"></a><span class="lineno">  168</span><span class="comment"> * @tparam S_MQ_TYPE_OR_NONE</span></div>
<div class="line"><a id="l00169" name="l00169"></a><span class="lineno">  169</span><span class="comment"> *         See #Server_session counterpart.</span></div>
<div class="line"><a id="l00170" name="l00170"></a><span class="lineno">  170</span><span class="comment"> * @tparam S_TRANSMIT_NATIVE_HANDLES</span></div>
<div class="line"><a id="l00171" name="l00171"></a><span class="lineno">  171</span><span class="comment"> *         See #Server_session counterpart.</span></div>
<div class="line"><a id="l00172" name="l00172"></a><span class="lineno">  172</span><span class="comment"> * @tparam Mdt_payload</span></div>
<div class="line"><a id="l00173" name="l00173"></a><span class="lineno">  173</span><span class="comment"> *         See #Server_session counterpart.</span></div>
<div class="line"><a id="l00174" name="l00174"></a><span class="lineno">  174</span><span class="comment"> * @tparam S_SHM_TYPE_OR_NONE</span></div>
<div class="line"><a id="l00175" name="l00175"></a><span class="lineno">  175</span><span class="comment"> *         See common.capnp `ShmType` capnp-`enum` definition.</span></div>
<div class="line"><a id="l00176" name="l00176"></a><span class="lineno">  176</span><span class="comment"> * @tparam S_SHM_MAX_HNDL_SZ</span></div>
<div class="line"><a id="l00177" name="l00177"></a><span class="lineno">  177</span><span class="comment"> *         Ignored if `S_SHM_TYPE_OR_NONE` indicates we are not SHM-enabled, this otherwise indicates the max</span></div>
<div class="line"><a id="l00178" name="l00178"></a><span class="lineno">  178</span><span class="comment"> *         size of a SHM handle&#39;s blob serialization.  If ignored it must be set to 0 (convention).</span></div>
<div class="line"><a id="l00179" name="l00179"></a><span class="lineno">  179</span><span class="comment"> * @tparam S_GRACEFUL_FINISH_REQUIRED_V</span></div>
<div class="line"><a id="l00180" name="l00180"></a><span class="lineno">  180</span><span class="comment"> *         `true` if and only if Session_base::Graceful_finisher must be used.</span></div>
<div class="line"><a id="l00181" name="l00181"></a><span class="lineno">  181</span><span class="comment"> *         See its doc header for explanation when that would be the case.</span></div>
<div class="line"><a id="l00182" name="l00182"></a><span class="lineno">  182</span><span class="comment"> */</span></div>
<div class="line"><a id="l00183" name="l00183"></a><span class="lineno">  183</span><span class="keyword">template</span>&lt;schema::MqType S_MQ_TYPE_OR_NONE, <span class="keywordtype">bool</span> S_TRANSMIT_NATIVE_HANDLES, <span class="keyword">typename</span> Mdt_payload,</div>
<div class="line"><a id="l00184" name="l00184"></a><span class="lineno">  184</span>         schema::ShmType S_SHM_TYPE_OR_NONE, <span class="keywordtype">size_t</span> S_SHM_MAX_HNDL_SZ, <span class="keywordtype">bool</span> S_GRACEFUL_FINISH_REQUIRED_V&gt;</div>
<div class="line"><a id="l00185" name="l00185"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html">  185</a></span><span class="keyword">class </span><a class="code hl_class" href="classipc_1_1session_1_1Server__session__impl.html">Server_session_impl</a> :</div>
<div class="line"><a id="l00186" name="l00186"></a><span class="lineno">  186</span>  <span class="keyword">public</span> <a class="code hl_class" href="classipc_1_1session_1_1Session__base.html">Session_base</a>&lt;S_MQ_TYPE_OR_NONE, S_TRANSMIT_NATIVE_HANDLES, Mdt_payload&gt;,</div>
<div class="line"><a id="l00187" name="l00187"></a><span class="lineno">  187</span>  <span class="keyword">public</span> flow::log::Log_context</div>
<div class="line"><a id="l00188" name="l00188"></a><span class="lineno">  188</span>{</div>
<div class="line"><a id="l00189" name="l00189"></a><span class="lineno">  189</span><span class="keyword">public</span>:</div>
<div class="line"><a id="l00190" name="l00190"></a><span class="lineno">  190</span>  <span class="comment">// Types.</span></div>
<div class="line"><a id="l00191" name="l00191"></a><span class="lineno">  191</span><span class="comment"></span> </div>
<div class="line"><a id="l00192" name="l00192"></a><span class="lineno">  192</span><span class="comment">  /// Short-hand for base type.</span></div>
<div class="line"><a id="l00193" name="l00193"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#a80daf8c8041d8d510f4712156732b09d">  193</a></span><span class="comment"></span>  <span class="keyword">using </span><a class="code hl_class" href="classipc_1_1session_1_1Session__base.html">Base</a> = <a class="code hl_class" href="classipc_1_1session_1_1Session__base.html">Session_base&lt;S_MQ_TYPE_OR_NONE, S_TRANSMIT_NATIVE_HANDLES, Mdt_payload&gt;</a>;</div>
<div class="line"><a id="l00194" name="l00194"></a><span class="lineno">  194</span><span class="comment"></span> </div>
<div class="line"><a id="l00195" name="l00195"></a><span class="lineno">  195</span><span class="comment">  /// Short-hand for Session_base super-class.</span></div>
<div class="line"><a id="l00196" name="l00196"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#a3797b21c6b9c430471e3d9835acb2979">  196</a></span><span class="comment"></span>  <span class="keyword">using </span><a class="code hl_class" href="classipc_1_1session_1_1Session__base.html">Session_base_obj</a> = <a class="code hl_typedef" href="classipc_1_1session_1_1Server__session__impl.html#a80daf8c8041d8d510f4712156732b09d">Base</a>;</div>
<div class="line"><a id="l00197" name="l00197"></a><span class="lineno">  197</span><span class="comment"></span> </div>
<div class="line"><a id="l00198" name="l00198"></a><span class="lineno">  198</span><span class="comment">  /// See Server_session_mv counterpart.</span></div>
<div class="line"><a id="l00199" name="l00199"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#a7c969c3a1007f8e4ba3ad1c1acd6c290">  199</a></span><span class="comment"></span>  <span class="keyword">using </span><a class="code hl_typedef" href="classipc_1_1session_1_1Server__session__impl.html#a7c969c3a1007f8e4ba3ad1c1acd6c290">Channel_obj</a> = <span class="keyword">typename</span> <a class="code hl_typedef" href="classipc_1_1session_1_1Session__base.html#a71f02a809d667c23ff8af29a96940bd1">Base::Channel_obj</a>;</div>
<div class="line"><a id="l00200" name="l00200"></a><span class="lineno">  200</span><span class="comment"></span> </div>
<div class="line"><a id="l00201" name="l00201"></a><span class="lineno">  201</span><span class="comment">  /// See Session_mv counterpart.</span></div>
<div class="line"><a id="l00202" name="l00202"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#a75df7061f9c57660f9fb944d83da416b">  202</a></span><span class="comment"></span>  <span class="keyword">using </span><a class="code hl_typedef" href="classipc_1_1session_1_1Server__session__impl.html#a75df7061f9c57660f9fb944d83da416b">Channels</a> = <span class="keyword">typename</span> <a class="code hl_typedef" href="classipc_1_1session_1_1Session__base.html#a638232ef74a0eb80aeb4f027ee06f9bf">Base::Channels</a>;</div>
<div class="line"><a id="l00203" name="l00203"></a><span class="lineno">  203</span><span class="comment"></span> </div>
<div class="line"><a id="l00204" name="l00204"></a><span class="lineno">  204</span><span class="comment">  /// See Server_session_mv counterpart.</span></div>
<div class="line"><a id="l00205" name="l00205"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#aa9cd0c1e6792a4ee096b55b13b4db803">  205</a></span><span class="comment"></span>  <span class="keyword">using </span><a class="code hl_typedef" href="classipc_1_1session_1_1Server__session__impl.html#aa9cd0c1e6792a4ee096b55b13b4db803">Mdt_payload_obj</a> = <span class="keyword">typename</span> <a class="code hl_typedef" href="classipc_1_1session_1_1Session__base.html#a35234981ca87cc2f6b118b3e52452ea8">Base::Mdt_payload_obj</a>;</div>
<div class="line"><a id="l00206" name="l00206"></a><span class="lineno">  206</span><span class="comment"></span> </div>
<div class="line"><a id="l00207" name="l00207"></a><span class="lineno">  207</span><span class="comment">  /// See Server_session_mv counterpart.</span></div>
<div class="line"><a id="l00208" name="l00208"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#a78e61f8681c7ec92fa19bae560763ab1">  208</a></span><span class="comment"></span>  <span class="keyword">using </span><a class="code hl_typedef" href="classipc_1_1session_1_1Server__session__impl.html#a78e61f8681c7ec92fa19bae560763ab1">Mdt_reader_ptr</a> = <span class="keyword">typename</span> <a class="code hl_typedef" href="classipc_1_1session_1_1Session__base.html#ace4dab42adec6354cc66081dd218ac71">Base::Mdt_reader_ptr</a>;</div>
<div class="line"><a id="l00209" name="l00209"></a><span class="lineno">  209</span><span class="comment"></span> </div>
<div class="line"><a id="l00210" name="l00210"></a><span class="lineno">  210</span><span class="comment">  /// See Server_session_mv counterpart.</span></div>
<div class="line"><a id="l00211" name="l00211"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#a7134fc9c4d26ba1fbc8e5da266d970e5">  211</a></span><span class="comment"></span>  <span class="keyword">using </span><a class="code hl_typedef" href="classipc_1_1session_1_1Server__session__impl.html#a7134fc9c4d26ba1fbc8e5da266d970e5">Mdt_builder</a> = <span class="keyword">typename</span> <a class="code hl_typedef" href="classipc_1_1session_1_1Session__base.html#a7d68bbb8c0c09983619d563bca30bd45">Base::Mdt_builder</a>;</div>
<div class="line"><a id="l00212" name="l00212"></a><span class="lineno">  212</span><span class="comment"></span> </div>
<div class="line"><a id="l00213" name="l00213"></a><span class="lineno">  213</span><span class="comment">  /// See Server_session_mv counterpart.</span></div>
<div class="line"><a id="l00214" name="l00214"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#ac4bc7e38574e0495af4887d2e6226b7a">  214</a></span><span class="comment"></span>  <span class="keyword">using </span><a class="code hl_typedef" href="classipc_1_1session_1_1Server__session__impl.html#ac4bc7e38574e0495af4887d2e6226b7a">Mdt_builder_ptr</a> = <span class="keyword">typename</span> <a class="code hl_typedef" href="classipc_1_1session_1_1Session__base.html#a4a7a5b83f6ba8bd505685636eabc012b">Base::Mdt_builder_ptr</a>;</div>
<div class="line"><a id="l00215" name="l00215"></a><span class="lineno">  215</span><span class="comment"></span> </div>
<div class="line"><a id="l00216" name="l00216"></a><span class="lineno">  216</span><span class="comment">  /// See Session_mv counterpart.</span></div>
<div class="line"><a id="l00217" name="l00217"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#abff6feea533de655f0cd8017d6ea3293">  217</a></span><span class="comment"></span>  <span class="keyword">using </span><a class="code hl_typedef" href="classipc_1_1session_1_1Server__session__impl.html#abff6feea533de655f0cd8017d6ea3293">Structured_msg_builder_config</a> = <span class="keyword">typename</span> <a class="code hl_typedef" href="classipc_1_1session_1_1Session__base.html#aee0db48505c84d3553b7110a9a815036">Base::Structured_msg_builder_config</a>;</div>
<div class="line"><a id="l00218" name="l00218"></a><span class="lineno">  218</span><span class="comment"></span> </div>
<div class="line"><a id="l00219" name="l00219"></a><span class="lineno">  219</span><span class="comment">  /// See Session_mv counterpart.</span></div>
<div class="line"><a id="l00220" name="l00220"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#ab8612a76df11f9db0d4f335848cda822">  220</a></span><span class="comment"></span>  <span class="keyword">using </span><a class="code hl_typedef" href="classipc_1_1session_1_1Server__session__impl.html#ab8612a76df11f9db0d4f335848cda822">Structured_msg_reader_config</a> = <span class="keyword">typename</span> <a class="code hl_typedef" href="classipc_1_1session_1_1Session__base.html#abd854f2b9316361ef18f15610c242d4b">Base::Structured_msg_reader_config</a>;</div>
<div class="line"><a id="l00221" name="l00221"></a><span class="lineno">  221</span> </div>
<div class="line"><a id="l00222" name="l00222"></a><span class="lineno">  222</span>  <span class="comment">// Constants.</span></div>
<div class="line"><a id="l00223" name="l00223"></a><span class="lineno">  223</span> </div>
<div class="line"><a id="l00224" name="l00224"></a><span class="lineno">  224</span>  <span class="keyword">static_assert</span>(S_SHM_TYPE_OR_NONE != schema::ShmType::END_SENTINEL,</div>
<div class="line"><a id="l00225" name="l00225"></a><span class="lineno">  225</span>                <span class="stringliteral">&quot;Do not set it to sentinel enum value which is only for counting # of possible values and such.&quot;</span>);</div>
<div class="line"><a id="l00226" name="l00226"></a><span class="lineno">  226</span><span class="comment"></span> </div>
<div class="line"><a id="l00227" name="l00227"></a><span class="lineno">  227</span><span class="comment">  /// See Session_mv counterpart.</span></div>
<div class="line"><a id="l00228" name="l00228"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#a582c808f7ea2104468e56bc135172296">  228</a></span><span class="comment"></span>  <span class="keyword">static</span> <span class="keyword">constexpr</span> schema::ShmType <a class="code hl_variable" href="classipc_1_1session_1_1Server__session__impl.html#a582c808f7ea2104468e56bc135172296">S_SHM_TYPE</a> = S_SHM_TYPE_OR_NONE;</div>
<div class="line"><a id="l00229" name="l00229"></a><span class="lineno">  229</span><span class="comment"></span> </div>
<div class="line"><a id="l00230" name="l00230"></a><span class="lineno">  230</span><span class="comment">  /// See Session_mv counterpart.</span></div>
<div class="line"><a id="l00231" name="l00231"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#a1ded7990451b90f29e11f8fa7ce0e80b">  231</a></span><span class="comment"></span>  <span class="keyword">static</span> <span class="keyword">constexpr</span> <span class="keywordtype">bool</span> <a class="code hl_variable" href="classipc_1_1session_1_1Server__session__impl.html#a1ded7990451b90f29e11f8fa7ce0e80b">S_SHM_ENABLED</a> = <a class="code hl_variable" href="classipc_1_1session_1_1Server__session__impl.html#a582c808f7ea2104468e56bc135172296">S_SHM_TYPE</a> != schema::ShmType::NONE;</div>
<div class="line"><a id="l00232" name="l00232"></a><span class="lineno">  232</span> </div>
<div class="line"><a id="l00233" name="l00233"></a><span class="lineno">  233</span>  <span class="keyword">static_assert</span>(<a class="code hl_variable" href="classipc_1_1session_1_1Server__session__impl.html#a1ded7990451b90f29e11f8fa7ce0e80b">S_SHM_ENABLED</a> || (S_SHM_MAX_HNDL_SZ == 0),</div>
<div class="line"><a id="l00234" name="l00234"></a><span class="lineno">  234</span>                <span class="stringliteral">&quot;S_SHM_MAX_HNDL_SZ is ignored if SHM disabled; and must be set to 0 by required convention.&quot;</span>);</div>
<div class="line"><a id="l00235" name="l00235"></a><span class="lineno">  235</span><span class="comment"></span> </div>
<div class="line"><a id="l00236" name="l00236"></a><span class="lineno">  236</span><span class="comment">  /// See Server_session_mv counterpart.</span></div>
<div class="line"><a id="l00237" name="l00237"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#a005fcbc9ee215531c03d17fcc49ef544">  237</a></span><span class="comment"></span>  <span class="keyword">static</span> <span class="keyword">constexpr</span> <span class="keywordtype">bool</span> <a class="code hl_variable" href="classipc_1_1session_1_1Server__session__impl.html#a005fcbc9ee215531c03d17fcc49ef544">S_MQS_ENABLED</a> = <a class="code hl_variable" href="classipc_1_1session_1_1Session__base.html#a27a5731a648effb6b4b42f0312affa74">Base::S_MQS_ENABLED</a>;</div>
<div class="line"><a id="l00238" name="l00238"></a><span class="lineno">  238</span><span class="comment"></span> </div>
<div class="line"><a id="l00239" name="l00239"></a><span class="lineno">  239</span><span class="comment">  /// See Server_session_mv counterpart.</span></div>
<div class="line"><a id="l00240" name="l00240"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#abfa7d61030e1d40cdc0085afacb43b6c">  240</a></span><span class="comment"></span>  <span class="keyword">static</span> <span class="keyword">constexpr</span> <span class="keywordtype">bool</span> <a class="code hl_variable" href="classipc_1_1session_1_1Server__session__impl.html#abfa7d61030e1d40cdc0085afacb43b6c">S_SOCKET_STREAM_ENABLED</a> = <a class="code hl_variable" href="classipc_1_1session_1_1Session__base.html#a1f7c4243c8bd55930f51a568884c8aaf">Base::S_SOCKET_STREAM_ENABLED</a>;</div>
<div class="line"><a id="l00241" name="l00241"></a><span class="lineno">  241</span><span class="comment"></span> </div>
<div class="line"><a id="l00242" name="l00242"></a><span class="lineno">  242</span><span class="comment">  /// Short-hand for template parameter knob `S_GRACEFUL_FINISH_REQUIRED_V`: see class template doc header.</span></div>
<div class="line"><a id="l00243" name="l00243"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#a0dc599111ce0b4b6d8cd003559e6c01c">  243</a></span><span class="comment"></span>  <span class="keyword">static</span> <span class="keyword">constexpr</span> <span class="keywordtype">bool</span> <a class="code hl_variable" href="classipc_1_1session_1_1Server__session__impl.html#a0dc599111ce0b4b6d8cd003559e6c01c">S_GRACEFUL_FINISH_REQUIRED</a> = S_GRACEFUL_FINISH_REQUIRED_V;</div>
<div class="line"><a id="l00244" name="l00244"></a><span class="lineno">  244</span> </div>
<div class="line"><a id="l00245" name="l00245"></a><span class="lineno">  245</span>  <span class="comment">// Constructors/destructor.</span></div>
<div class="line"><a id="l00246" name="l00246"></a><span class="lineno">  246</span><span class="comment"></span> </div>
<div class="line"><a id="l00247" name="l00247"></a><span class="lineno">  247</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00248" name="l00248"></a><span class="lineno">  248</span><span class="comment">   * For use by internal user Session_server: See Server_session_mv counterpart.</span></div>
<div class="line"><a id="l00249" name="l00249"></a><span class="lineno">  249</span><span class="comment">   *</span></div>
<div class="line"><a id="l00250" name="l00250"></a><span class="lineno">  250</span><span class="comment">   * @param logger_ptr</span></div>
<div class="line"><a id="l00251" name="l00251"></a><span class="lineno">  251</span><span class="comment">   *        See Server_session_mv counterpart.</span></div>
<div class="line"><a id="l00252" name="l00252"></a><span class="lineno">  252</span><span class="comment">   * @param srv_app_ref</span></div>
<div class="line"><a id="l00253" name="l00253"></a><span class="lineno">  253</span><span class="comment">   *        See Server_session_mv counterpart.</span></div>
<div class="line"><a id="l00254" name="l00254"></a><span class="lineno">  254</span><span class="comment">   * @param master_channel_sock_stm</span></div>
<div class="line"><a id="l00255" name="l00255"></a><span class="lineno">  255</span><span class="comment">   *        See Server_session_mv counterpart.</span></div>
<div class="line"><a id="l00256" name="l00256"></a><span class="lineno">  256</span><span class="comment">   */</span></div>
<div class="line"><a id="l00257" name="l00257"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#a424215b95b49fea0b3b3986688395158">  257</a></span>  <span class="keyword">explicit</span> <a class="code hl_function" href="classipc_1_1session_1_1Server__session__impl.html#a424215b95b49fea0b3b3986688395158">Server_session_impl</a>(flow::log::Logger* logger_ptr, <span class="keyword">const</span> <a class="code hl_struct" href="structipc_1_1session_1_1Server__app.html">Server_app</a>&amp; srv_app_ref,</div>
<div class="line"><a id="l00258" name="l00258"></a><span class="lineno">  258</span>                               <a class="code hl_class" href="classipc_1_1transport_1_1sync__io_1_1Native__socket__stream.html">transport::sync_io::Native_socket_stream</a>&amp;&amp; master_channel_sock_stm);</div>
<div class="line"><a id="l00259" name="l00259"></a><span class="lineno">  259</span><span class="comment"></span> </div>
<div class="line"><a id="l00260" name="l00260"></a><span class="lineno">  260</span><span class="comment">  /// See Server_session_mv counterpart.</span></div>
<div class="line"><a id="l00261" name="l00261"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#a145389df1784d5242adf69e2cc9826cd">  261</a></span><span class="comment"></span>  <a class="code hl_function" href="classipc_1_1session_1_1Server__session__impl.html#a145389df1784d5242adf69e2cc9826cd">~Server_session_impl</a>();</div>
<div class="line"><a id="l00262" name="l00262"></a><span class="lineno">  262</span> </div>
<div class="line"><a id="l00263" name="l00263"></a><span class="lineno">  263</span>  <span class="comment">// Methods.</span></div>
<div class="line"><a id="l00264" name="l00264"></a><span class="lineno">  264</span><span class="comment"></span> </div>
<div class="line"><a id="l00265" name="l00265"></a><span class="lineno">  265</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00266" name="l00266"></a><span class="lineno">  266</span><span class="comment">   * For use by internal user Session_server: See Server_session_mv counterpart.</span></div>
<div class="line"><a id="l00267" name="l00267"></a><span class="lineno">  267</span><span class="comment">   *</span></div>
<div class="line"><a id="l00268" name="l00268"></a><span class="lineno">  268</span><span class="comment">   * @param srv</span></div>
<div class="line"><a id="l00269" name="l00269"></a><span class="lineno">  269</span><span class="comment">   *        See Server_session_mv counterpart.</span></div>
<div class="line"><a id="l00270" name="l00270"></a><span class="lineno">  270</span><span class="comment">   * @param init_channels_by_srv_req</span></div>
<div class="line"><a id="l00271" name="l00271"></a><span class="lineno">  271</span><span class="comment">   *        See Server_session_mv counterpart.</span></div>
<div class="line"><a id="l00272" name="l00272"></a><span class="lineno">  272</span><span class="comment">   * @param mdt_from_cli_or_null</span></div>
<div class="line"><a id="l00273" name="l00273"></a><span class="lineno">  273</span><span class="comment">   *        See Server_session_mv counterpart.</span></div>
<div class="line"><a id="l00274" name="l00274"></a><span class="lineno">  274</span><span class="comment">   * @param init_channels_by_cli_req</span></div>
<div class="line"><a id="l00275" name="l00275"></a><span class="lineno">  275</span><span class="comment">   *        See Server_session_mv counterpart.</span></div>
<div class="line"><a id="l00276" name="l00276"></a><span class="lineno">  276</span><span class="comment">   * @param cli_app_lookup_func</span></div>
<div class="line"><a id="l00277" name="l00277"></a><span class="lineno">  277</span><span class="comment">   *        See Server_session_mv counterpart.</span></div>
<div class="line"><a id="l00278" name="l00278"></a><span class="lineno">  278</span><span class="comment">   * @param cli_namespace_func</span></div>
<div class="line"><a id="l00279" name="l00279"></a><span class="lineno">  279</span><span class="comment">   *        See Server_session_mv counterpart.</span></div>
<div class="line"><a id="l00280" name="l00280"></a><span class="lineno">  280</span><span class="comment">   * @param pre_rsp_setup_func</span></div>
<div class="line"><a id="l00281" name="l00281"></a><span class="lineno">  281</span><span class="comment">   *        See Server_session_mv counterpart.</span></div>
<div class="line"><a id="l00282" name="l00282"></a><span class="lineno">  282</span><span class="comment">   * @param n_init_channels_by_srv_req_func</span></div>
<div class="line"><a id="l00283" name="l00283"></a><span class="lineno">  283</span><span class="comment">   *        See Server_session_mv counterpart.</span></div>
<div class="line"><a id="l00284" name="l00284"></a><span class="lineno">  284</span><span class="comment">   * @param mdt_load_func</span></div>
<div class="line"><a id="l00285" name="l00285"></a><span class="lineno">  285</span><span class="comment">   *        See Server_session_mv counterpart.</span></div>
<div class="line"><a id="l00286" name="l00286"></a><span class="lineno">  286</span><span class="comment">   * @param on_done_func</span></div>
<div class="line"><a id="l00287" name="l00287"></a><span class="lineno">  287</span><span class="comment">   *        See Server_session_mv counterpart.</span></div>
<div class="line"><a id="l00288" name="l00288"></a><span class="lineno">  288</span><span class="comment">   */</span></div>
<div class="line"><a id="l00289" name="l00289"></a><span class="lineno">  289</span>  <span class="keyword">template</span>&lt;<span class="keyword">typename</span> Session_server_impl_t,</div>
<div class="line"><a id="l00290" name="l00290"></a><span class="lineno">  290</span>           <span class="keyword">typename</span> Task_err, <span class="keyword">typename</span> Cli_app_lookup_func, <span class="keyword">typename</span> Cli_namespace_func, <span class="keyword">typename</span> Pre_rsp_setup_func,</div>
<div class="line"><a id="l00291" name="l00291"></a><span class="lineno">  291</span>           <span class="keyword">typename</span> N_init_channels_by_srv_req_func, <span class="keyword">typename</span> Mdt_load_func&gt;</div>
<div class="line"><a id="l00292" name="l00292"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#aee35d521d9997d48f6b5565730e60e93">  292</a></span>  <span class="keywordtype">void</span> <a class="code hl_function" href="classipc_1_1session_1_1Server__session__impl.html#aee35d521d9997d48f6b5565730e60e93">async_accept_log_in</a>(Session_server_impl_t* srv,</div>
<div class="line"><a id="l00293" name="l00293"></a><span class="lineno">  293</span>                           <a class="code hl_typedef" href="classipc_1_1session_1_1Session__base.html#a638232ef74a0eb80aeb4f027ee06f9bf">Channels</a>* init_channels_by_srv_req,</div>
<div class="line"><a id="l00294" name="l00294"></a><span class="lineno">  294</span>                           <a class="code hl_typedef" href="classipc_1_1session_1_1Session__base.html#ace4dab42adec6354cc66081dd218ac71">Mdt_reader_ptr</a>* mdt_from_cli_or_null,</div>
<div class="line"><a id="l00295" name="l00295"></a><span class="lineno">  295</span>                           <a class="code hl_typedef" href="classipc_1_1session_1_1Session__base.html#a638232ef74a0eb80aeb4f027ee06f9bf">Channels</a>* init_channels_by_cli_req,</div>
<div class="line"><a id="l00296" name="l00296"></a><span class="lineno">  296</span>                           Cli_app_lookup_func&amp;&amp; cli_app_lookup_func, Cli_namespace_func&amp;&amp; cli_namespace_func,</div>
<div class="line"><a id="l00297" name="l00297"></a><span class="lineno">  297</span>                           Pre_rsp_setup_func&amp;&amp; pre_rsp_setup_func,</div>
<div class="line"><a id="l00298" name="l00298"></a><span class="lineno">  298</span>                           N_init_channels_by_srv_req_func&amp;&amp; n_init_channels_by_srv_req_func,</div>
<div class="line"><a id="l00299" name="l00299"></a><span class="lineno">  299</span>                           Mdt_load_func&amp;&amp; mdt_load_func,</div>
<div class="line"><a id="l00300" name="l00300"></a><span class="lineno">  300</span>                           Task_err&amp;&amp; on_done_func);</div>
<div class="line"><a id="l00301" name="l00301"></a><span class="lineno">  301</span><span class="comment"></span> </div>
<div class="line"><a id="l00302" name="l00302"></a><span class="lineno">  302</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00303" name="l00303"></a><span class="lineno">  303</span><span class="comment">   * See Server_session_mv counterpart.</span></div>
<div class="line"><a id="l00304" name="l00304"></a><span class="lineno">  304</span><span class="comment">   * @return See Server_session_mv counterpart.</span></div>
<div class="line"><a id="l00305" name="l00305"></a><span class="lineno">  305</span><span class="comment">   */</span></div>
<div class="line"><a id="l00306" name="l00306"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#a3deaeacf53a8fc63ed010394ef82c54c">  306</a></span>  <span class="keyword">const</span> <a class="code hl_struct" href="structipc_1_1session_1_1Client__app.html">Client_app</a>* <a class="code hl_function" href="classipc_1_1session_1_1Server__session__impl.html#a3deaeacf53a8fc63ed010394ef82c54c">client_app</a>() <span class="keyword">const</span>;</div>
<div class="line"><a id="l00307" name="l00307"></a><span class="lineno">  307</span><span class="comment"></span> </div>
<div class="line"><a id="l00308" name="l00308"></a><span class="lineno">  308</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00309" name="l00309"></a><span class="lineno">  309</span><span class="comment">   * See Server_session_mv counterpart.</span></div>
<div class="line"><a id="l00310" name="l00310"></a><span class="lineno">  310</span><span class="comment">   *</span></div>
<div class="line"><a id="l00311" name="l00311"></a><span class="lineno">  311</span><span class="comment">   * @param on_err_func_arg</span></div>
<div class="line"><a id="l00312" name="l00312"></a><span class="lineno">  312</span><span class="comment">   *        See Server_session_mv counterpart.</span></div>
<div class="line"><a id="l00313" name="l00313"></a><span class="lineno">  313</span><span class="comment">   * @param on_passive_open_channel_func_arg</span></div>
<div class="line"><a id="l00314" name="l00314"></a><span class="lineno">  314</span><span class="comment">   *        See Server_session_mv counterpart.</span></div>
<div class="line"><a id="l00315" name="l00315"></a><span class="lineno">  315</span><span class="comment">   * @return See Server_session_mv counterpart.</span></div>
<div class="line"><a id="l00316" name="l00316"></a><span class="lineno">  316</span><span class="comment">   */</span></div>
<div class="line"><a id="l00317" name="l00317"></a><span class="lineno">  317</span>  <span class="keyword">template</span>&lt;<span class="keyword">typename</span> Task_err, <span class="keyword">typename</span> On_passive_open_channel_handler&gt;</div>
<div class="line"><a id="l00318" name="l00318"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#ac93040ccdaf5a261a053a8b55bd2e14e">  318</a></span>  <span class="keywordtype">bool</span> <a class="code hl_function" href="classipc_1_1session_1_1Server__session__impl.html#ac93040ccdaf5a261a053a8b55bd2e14e">init_handlers</a>(Task_err&amp;&amp; on_err_func_arg, On_passive_open_channel_handler&amp;&amp; on_passive_open_channel_func_arg);</div>
<div class="line"><a id="l00319" name="l00319"></a><span class="lineno">  319</span><span class="comment"></span> </div>
<div class="line"><a id="l00320" name="l00320"></a><span class="lineno">  320</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00321" name="l00321"></a><span class="lineno">  321</span><span class="comment">   * See Server_session_mv counterpart.</span></div>
<div class="line"><a id="l00322" name="l00322"></a><span class="lineno">  322</span><span class="comment">   *</span></div>
<div class="line"><a id="l00323" name="l00323"></a><span class="lineno">  323</span><span class="comment">   * @param on_err_func_arg</span></div>
<div class="line"><a id="l00324" name="l00324"></a><span class="lineno">  324</span><span class="comment">   *        See Server_session_mv counterpart.</span></div>
<div class="line"><a id="l00325" name="l00325"></a><span class="lineno">  325</span><span class="comment">   * @return See Server_session_mv counterpart.</span></div>
<div class="line"><a id="l00326" name="l00326"></a><span class="lineno">  326</span><span class="comment">   */</span></div>
<div class="line"><a id="l00327" name="l00327"></a><span class="lineno">  327</span>  <span class="keyword">template</span>&lt;<span class="keyword">typename</span> Task_err&gt;</div>
<div class="line"><a id="l00328" name="l00328"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#a493937b9737f1fc4803364c35ceae83e">  328</a></span>  <span class="keywordtype">bool</span> <a class="code hl_function" href="classipc_1_1session_1_1Server__session__impl.html#a493937b9737f1fc4803364c35ceae83e">init_handlers</a>(Task_err&amp;&amp; on_err_func_arg);</div>
<div class="line"><a id="l00329" name="l00329"></a><span class="lineno">  329</span><span class="comment"></span> </div>
<div class="line"><a id="l00330" name="l00330"></a><span class="lineno">  330</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00331" name="l00331"></a><span class="lineno">  331</span><span class="comment">   * See Server_session_mv counterpart.</span></div>
<div class="line"><a id="l00332" name="l00332"></a><span class="lineno">  332</span><span class="comment">   * @return See Server_session_mv counterpart.</span></div>
<div class="line"><a id="l00333" name="l00333"></a><span class="lineno">  333</span><span class="comment">   */</span></div>
<div class="line"><a id="l00334" name="l00334"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#a138956765a655240080491157f316167">  334</a></span>  <a class="code hl_typedef" href="classipc_1_1session_1_1Session__base.html#a4a7a5b83f6ba8bd505685636eabc012b">Mdt_builder_ptr</a> <a class="code hl_function" href="classipc_1_1session_1_1Server__session__impl.html#a138956765a655240080491157f316167">mdt_builder</a>();</div>
<div class="line"><a id="l00335" name="l00335"></a><span class="lineno">  335</span><span class="comment"></span> </div>
<div class="line"><a id="l00336" name="l00336"></a><span class="lineno">  336</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00337" name="l00337"></a><span class="lineno">  337</span><span class="comment">   * See Server_session_mv counterpart.</span></div>
<div class="line"><a id="l00338" name="l00338"></a><span class="lineno">  338</span><span class="comment">   *</span></div>
<div class="line"><a id="l00339" name="l00339"></a><span class="lineno">  339</span><span class="comment">   * @param target_channel</span></div>
<div class="line"><a id="l00340" name="l00340"></a><span class="lineno">  340</span><span class="comment">   *        See Server_session_mv counterpart.</span></div>
<div class="line"><a id="l00341" name="l00341"></a><span class="lineno">  341</span><span class="comment">   * @param mdt</span></div>
<div class="line"><a id="l00342" name="l00342"></a><span class="lineno">  342</span><span class="comment">   *        See Server_session_mv counterpart.</span></div>
<div class="line"><a id="l00343" name="l00343"></a><span class="lineno">  343</span><span class="comment">   * @param err_code</span></div>
<div class="line"><a id="l00344" name="l00344"></a><span class="lineno">  344</span><span class="comment">   *        See Server_session_mv counterpart.</span></div>
<div class="line"><a id="l00345" name="l00345"></a><span class="lineno">  345</span><span class="comment">   * @return See Server_session_mv counterpart.</span></div>
<div class="line"><a id="l00346" name="l00346"></a><span class="lineno">  346</span><span class="comment">   */</span></div>
<div class="line"><a id="l00347" name="l00347"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#a45a5ae92b706ea539c27be0d19a303c4">  347</a></span>  <span class="keywordtype">bool</span> <a class="code hl_function" href="classipc_1_1session_1_1Server__session__impl.html#a45a5ae92b706ea539c27be0d19a303c4">open_channel</a>(<a class="code hl_typedef" href="classipc_1_1session_1_1Session__base.html#a71f02a809d667c23ff8af29a96940bd1">Channel_obj</a>* target_channel, <span class="keyword">const</span> <a class="code hl_typedef" href="classipc_1_1session_1_1Session__base.html#a4a7a5b83f6ba8bd505685636eabc012b">Mdt_builder_ptr</a>&amp; mdt, <a class="code hl_typedef" href="namespaceipc.html#aa3192e586cc45d3e7c22463bf2760f89">Error_code</a>* err_code = 0);</div>
<div class="line"><a id="l00348" name="l00348"></a><span class="lineno">  348</span><span class="comment"></span> </div>
<div class="line"><a id="l00349" name="l00349"></a><span class="lineno">  349</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00350" name="l00350"></a><span class="lineno">  350</span><span class="comment">   * See Server_session_mv counterpart.</span></div>
<div class="line"><a id="l00351" name="l00351"></a><span class="lineno">  351</span><span class="comment">   *</span></div>
<div class="line"><a id="l00352" name="l00352"></a><span class="lineno">  352</span><span class="comment">   * @param target_channel</span></div>
<div class="line"><a id="l00353" name="l00353"></a><span class="lineno">  353</span><span class="comment">   *        See Server_session_mv counterpart.</span></div>
<div class="line"><a id="l00354" name="l00354"></a><span class="lineno">  354</span><span class="comment">   * @param err_code</span></div>
<div class="line"><a id="l00355" name="l00355"></a><span class="lineno">  355</span><span class="comment">   *        See Server_session_mv counterpart.</span></div>
<div class="line"><a id="l00356" name="l00356"></a><span class="lineno">  356</span><span class="comment">   * @return See Server_session_mv counterpart.</span></div>
<div class="line"><a id="l00357" name="l00357"></a><span class="lineno">  357</span><span class="comment">   */</span></div>
<div class="line"><a id="l00358" name="l00358"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#adfb10992398b46be3b0e1ac0c8605ef4">  358</a></span>  <span class="keywordtype">bool</span> <a class="code hl_function" href="classipc_1_1session_1_1Server__session__impl.html#adfb10992398b46be3b0e1ac0c8605ef4">open_channel</a>(<a class="code hl_typedef" href="classipc_1_1session_1_1Session__base.html#a71f02a809d667c23ff8af29a96940bd1">Channel_obj</a>* target_channel, <a class="code hl_typedef" href="namespaceipc.html#aa3192e586cc45d3e7c22463bf2760f89">Error_code</a>* err_code = 0);</div>
<div class="line"><a id="l00359" name="l00359"></a><span class="lineno">  359</span><span class="comment"></span> </div>
<div class="line"><a id="l00360" name="l00360"></a><span class="lineno">  360</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00361" name="l00361"></a><span class="lineno">  361</span><span class="comment">   * See Server_session_mv counterpart.</span></div>
<div class="line"><a id="l00362" name="l00362"></a><span class="lineno">  362</span><span class="comment">   * @return See Server_session_mv counterpart.</span></div>
<div class="line"><a id="l00363" name="l00363"></a><span class="lineno">  363</span><span class="comment">   */</span></div>
<div class="line"><a id="l00364" name="l00364"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#a22e1464a8bc4b806bf3a91e932b31813">  364</a></span>  <span class="keyword">const</span> <a class="code hl_typedef" href="namespaceipc_1_1session.html#ade2b302f1a3623e8adc9694568d94d2c">Session_token</a>&amp; <a class="code hl_function" href="classipc_1_1session_1_1Server__session__impl.html#a22e1464a8bc4b806bf3a91e932b31813">session_token</a>() <span class="keyword">const</span>;</div>
<div class="line"><a id="l00365" name="l00365"></a><span class="lineno">  365</span><span class="comment"></span> </div>
<div class="line"><a id="l00366" name="l00366"></a><span class="lineno">  366</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00367" name="l00367"></a><span class="lineno">  367</span><span class="comment">   * See Server_session_mv counterpart.</span></div>
<div class="line"><a id="l00368" name="l00368"></a><span class="lineno">  368</span><span class="comment">   * @return See Server_session_mv counterpart.</span></div>
<div class="line"><a id="l00369" name="l00369"></a><span class="lineno">  369</span><span class="comment">   */</span></div>
<div class="line"><a id="l00370" name="l00370"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#a0992cbc57bf346d6b8df191f2dcb9188">  370</a></span>  <span class="keyword">const</span> <a class="code hl_class" href="classipc_1_1session_1_1Session__base.html">Base</a>&amp; <a class="code hl_function" href="classipc_1_1session_1_1Server__session__impl.html#a0992cbc57bf346d6b8df191f2dcb9188">base</a>() <span class="keyword">const</span>;</div>
<div class="line"><a id="l00371" name="l00371"></a><span class="lineno">  371</span> </div>
<div class="line"><a id="l00372" name="l00372"></a><span class="lineno">  372</span><span class="keyword">protected</span>:</div>
<div class="line"><a id="l00373" name="l00373"></a><span class="lineno">  373</span>  <span class="comment">// Types.</span></div>
<div class="line"><a id="l00374" name="l00374"></a><span class="lineno">  374</span><span class="comment"></span> </div>
<div class="line"><a id="l00375" name="l00375"></a><span class="lineno">  375</span><span class="comment">  /// See Session_base.</span></div>
<div class="line"><a id="l00376" name="l00376"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#a3bc90eb872c3f4d4ff65039a4a36b166">  376</a></span><span class="comment"></span>  <span class="keyword">using </span><a class="code hl_typedef" href="classipc_1_1session_1_1Server__session__impl.html#a3bc90eb872c3f4d4ff65039a4a36b166">Master_structured_channel</a> = <span class="keyword">typename</span> <a class="code hl_typedef" href="classipc_1_1session_1_1Session__base.html#a26d038e14e3c0e461e76de88c4ce76c5">Base::Master_structured_channel</a>;</div>
<div class="line"><a id="l00377" name="l00377"></a><span class="lineno">  377</span> </div>
<div class="line"><a id="l00378" name="l00378"></a><span class="lineno">  378</span>  <span class="comment">// Methods.</span></div>
<div class="line"><a id="l00379" name="l00379"></a><span class="lineno">  379</span><span class="comment"></span> </div>
<div class="line"><a id="l00380" name="l00380"></a><span class="lineno">  380</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00381" name="l00381"></a><span class="lineno">  381</span><span class="comment">   * Utility for sub-classes: ensures that `task()` is invoked near the end of `*this` dtor&#39;s execution, from thread</span></div>
<div class="line"><a id="l00382" name="l00382"></a><span class="lineno">  382</span><span class="comment">   * U, after thread W is joined, and any async_accept_log_in() on-done handler has fired with operation-aborted code.</span></div>
<div class="line"><a id="l00383" name="l00383"></a><span class="lineno">  383</span><span class="comment">   * It requires being invoked from thread W.  (Behavior is undefined otherwise; assertion may trip.)</span></div>
<div class="line"><a id="l00384" name="l00384"></a><span class="lineno">  384</span><span class="comment">   *</span></div>
<div class="line"><a id="l00385" name="l00385"></a><span class="lineno">  385</span><span class="comment">   * The value it adds: A long story best told by specific example.  See the original use case which is</span></div>
<div class="line"><a id="l00386" name="l00386"></a><span class="lineno">  386</span><span class="comment">   * in shm::classic::Server_session_impl::async_accept_log_in(); it sets up certain SHM cleanup steps to occur,</span></div>
<div class="line"><a id="l00387" name="l00387"></a><span class="lineno">  387</span><span class="comment">   * when the session ends.</span></div>
<div class="line"><a id="l00388" name="l00388"></a><span class="lineno">  388</span><span class="comment">   *</span></div>
<div class="line"><a id="l00389" name="l00389"></a><span class="lineno">  389</span><span class="comment">   * As of this writing this can be invoked 2+ times if desired, but really the spirit of it is to either never</span></div>
<div class="line"><a id="l00390" name="l00390"></a><span class="lineno">  390</span><span class="comment">   * call it, or call it exactly once during a certain stage of async_accept_log_in()&#39;s async portion.</span></div>
<div class="line"><a id="l00391" name="l00391"></a><span class="lineno">  391</span><span class="comment">   *</span></div>
<div class="line"><a id="l00392" name="l00392"></a><span class="lineno">  392</span><span class="comment">   * ### Watch out! ###</span></div>
<div class="line"><a id="l00393" name="l00393"></a><span class="lineno">  393</span><span class="comment">   * At the time `task()` runs, the calling instance of the sub-class has been destroyed -- thus it is, e.g.,</span></div>
<div class="line"><a id="l00394" name="l00394"></a><span class="lineno">  394</span><span class="comment">   * usually wrong to capture your `this` in the `task` lambda, except for logging.</span></div>
<div class="line"><a id="l00395" name="l00395"></a><span class="lineno">  395</span><span class="comment">   * `get_logger()` and `get_log_component()` (which are immutable state) are still okay to use.</span></div>
<div class="line"><a id="l00396" name="l00396"></a><span class="lineno">  396</span><span class="comment">   *</span></div>
<div class="line"><a id="l00397" name="l00397"></a><span class="lineno">  397</span><span class="comment">   * @tparam Task</span></div>
<div class="line"><a id="l00398" name="l00398"></a><span class="lineno">  398</span><span class="comment">   *         Function object invoked as `void` with no args.</span></div>
<div class="line"><a id="l00399" name="l00399"></a><span class="lineno">  399</span><span class="comment">   * @param task</span></div>
<div class="line"><a id="l00400" name="l00400"></a><span class="lineno">  400</span><span class="comment">   *        `task()` shall execute before dtor returns.</span></div>
<div class="line"><a id="l00401" name="l00401"></a><span class="lineno">  401</span><span class="comment">   */</span></div>
<div class="line"><a id="l00402" name="l00402"></a><span class="lineno">  402</span>  <span class="keyword">template</span>&lt;<span class="keyword">typename</span> Task&gt;</div>
<div class="line"><a id="l00403" name="l00403"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#a2276a6fd556861a9e0856360fde58158">  403</a></span>  <span class="keywordtype">void</span> <a class="code hl_function" href="classipc_1_1session_1_1Server__session__impl.html#a2276a6fd556861a9e0856360fde58158">sub_class_set_deinit_func</a>(<a class="code hl_typedef" href="namespaceipc_1_1util.html#a31e67d3a017477a04b313927e2f2c733">Task</a>&amp;&amp; task);</div>
<div class="line"><a id="l00404" name="l00404"></a><span class="lineno">  404</span><span class="comment"></span> </div>
<div class="line"><a id="l00405" name="l00405"></a><span class="lineno">  405</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00406" name="l00406"></a><span class="lineno">  406</span><span class="comment">   * Utility for sub-classes: provides ability to schedule or post tasks onto thread W.</span></div>
<div class="line"><a id="l00407" name="l00407"></a><span class="lineno">  407</span><span class="comment">   * @return See above.</span></div>
<div class="line"><a id="l00408" name="l00408"></a><span class="lineno">  408</span><span class="comment">   */</span></div>
<div class="line"><a id="l00409" name="l00409"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#a149a11c639d26b8a21279724079f6c2a">  409</a></span>  flow::async::Single_thread_task_loop* <a class="code hl_function" href="classipc_1_1session_1_1Server__session__impl.html#a149a11c639d26b8a21279724079f6c2a">async_worker</a>();</div>
<div class="line"><a id="l00410" name="l00410"></a><span class="lineno">  410</span><span class="comment"></span> </div>
<div class="line"><a id="l00411" name="l00411"></a><span class="lineno">  411</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00412" name="l00412"></a><span class="lineno">  412</span><span class="comment">   * Utility for sub-classes: provides ability to do work on the session master channel after our async_accept_log_in()</span></div>
<div class="line"><a id="l00413" name="l00413"></a><span class="lineno">  413</span><span class="comment">   * succeeds, but before the sub-classed wrapper of its on-done handler succeeds.</span></div>
<div class="line"><a id="l00414" name="l00414"></a><span class="lineno">  414</span><span class="comment">   *</span></div>
<div class="line"><a id="l00415" name="l00415"></a><span class="lineno">  415</span><span class="comment">   * This is pushing my (ygoldfel) (and from coding guide) suggestion to avoid unrestricted `protected` access</span></div>
<div class="line"><a id="l00416" name="l00416"></a><span class="lineno">  416</span><span class="comment">   * to data members.  It still &quot;feels&quot; okay but....  Hmmm.</span></div>
<div class="line"><a id="l00417" name="l00417"></a><span class="lineno">  417</span><span class="comment">   *</span></div>
<div class="line"><a id="l00418" name="l00418"></a><span class="lineno">  418</span><span class="comment">   * @return See above.</span></div>
<div class="line"><a id="l00419" name="l00419"></a><span class="lineno">  419</span><span class="comment">   */</span></div>
<div class="line"><a id="l00420" name="l00420"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#a14d68714c197ba58b4cb485262fb9d51">  420</a></span>  <a class="code hl_class" href="classipc_1_1transport_1_1struc_1_1Channel.html">Master_structured_channel</a>* <a class="code hl_function" href="classipc_1_1session_1_1Server__session__impl.html#a14d68714c197ba58b4cb485262fb9d51">master_channel</a>();</div>
<div class="line"><a id="l00421" name="l00421"></a><span class="lineno">  421</span><span class="comment"></span> </div>
<div class="line"><a id="l00422" name="l00422"></a><span class="lineno">  422</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00423" name="l00423"></a><span class="lineno">  423</span><span class="comment">   * Analogous to Client_session_impl::master_channel_const().  See that doc header.</span></div>
<div class="line"><a id="l00424" name="l00424"></a><span class="lineno">  424</span><span class="comment">   * @return See above.</span></div>
<div class="line"><a id="l00425" name="l00425"></a><span class="lineno">  425</span><span class="comment">   */</span></div>
<div class="line"><a id="l00426" name="l00426"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#aaa570a2ceb242370eeccca85d806fbbf">  426</a></span>  <span class="keyword">const</span> <a class="code hl_class" href="classipc_1_1transport_1_1struc_1_1Channel.html">Master_structured_channel</a>&amp; <a class="code hl_function" href="classipc_1_1session_1_1Server__session__impl.html#aaa570a2ceb242370eeccca85d806fbbf">master_channel_const</a>() <span class="keyword">const</span>;</div>
<div class="line"><a id="l00427" name="l00427"></a><span class="lineno">  427</span><span class="comment"></span> </div>
<div class="line"><a id="l00428" name="l00428"></a><span class="lineno">  428</span><span class="comment">  /// Analogous to Client_session_impl::dtor_async_worker_stop().  See that doc header.</span></div>
<div class="line"><a id="l00429" name="l00429"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#a28503a7c6622aacc7e08d4904da10da3">  429</a></span><span class="comment"></span>  <span class="keywordtype">void</span> <a class="code hl_function" href="classipc_1_1session_1_1Server__session__impl.html#a28503a7c6622aacc7e08d4904da10da3">dtor_async_worker_stop</a>();</div>
<div class="line"><a id="l00430" name="l00430"></a><span class="lineno">  430</span> </div>
<div class="line"><a id="l00431" name="l00431"></a><span class="lineno">  431</span><span class="keyword">private</span>:</div>
<div class="line"><a id="l00432" name="l00432"></a><span class="lineno">  432</span>  <span class="comment">// Types.</span></div>
<div class="line"><a id="l00433" name="l00433"></a><span class="lineno">  433</span><span class="comment"></span> </div>
<div class="line"><a id="l00434" name="l00434"></a><span class="lineno">  434</span><span class="comment">  /// See Session_base.</span></div>
<div class="line"><a id="l00435" name="l00435"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#aa72ad11c33a4d11d5e3f0480ce0a6ff1">  435</a></span><span class="comment"></span>  <span class="keyword">using </span><a class="code hl_typedef" href="classipc_1_1session_1_1Server__session__impl.html#aa72ad11c33a4d11d5e3f0480ce0a6ff1">Persistent_mq_handle_from_cfg</a> = <span class="keyword">typename</span> <a class="code hl_typedef" href="classipc_1_1session_1_1Session__base.html#a848c0f5247644ada0f8b0ab816eedda8">Base::Persistent_mq_handle_from_cfg</a>;</div>
<div class="line"><a id="l00436" name="l00436"></a><span class="lineno">  436</span><span class="comment"></span> </div>
<div class="line"><a id="l00437" name="l00437"></a><span class="lineno">  437</span><span class="comment">  /// See Session_base.</span></div>
<div class="line"><a id="l00438" name="l00438"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#af8013f82c2441d07bc82eda7cc3ad835">  438</a></span><span class="comment"></span>  <span class="keyword">using </span><a class="code hl_typedef" href="classipc_1_1session_1_1Server__session__impl.html#af8013f82c2441d07bc82eda7cc3ad835">On_passive_open_channel_func</a> = <span class="keyword">typename</span> <a class="code hl_typedef" href="classipc_1_1session_1_1Session__base.html#a3c0824a54ef32915c5c5ea76481f2409">Base::On_passive_open_channel_func</a>;</div>
<div class="line"><a id="l00439" name="l00439"></a><span class="lineno">  439</span><span class="comment"></span> </div>
<div class="line"><a id="l00440" name="l00440"></a><span class="lineno">  440</span><span class="comment">  /// See Session_base.</span></div>
<div class="line"><a id="l00441" name="l00441"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#ab6cfad1c0be9815dc5411cd20c131213">  441</a></span><span class="comment"></span>  <span class="keyword">using </span><a class="code hl_typedef" href="classipc_1_1session_1_1Server__session__impl.html#ab6cfad1c0be9815dc5411cd20c131213">Master_structured_channel_ptr</a> = <span class="keyword">typename</span> <a class="code hl_typedef" href="classipc_1_1session_1_1Session__base.html#af0ca2a01d7d0d92038aae56fc1cdd505">Base::Master_structured_channel_ptr</a>;</div>
<div class="line"><a id="l00442" name="l00442"></a><span class="lineno">  442</span><span class="comment"></span> </div>
<div class="line"><a id="l00443" name="l00443"></a><span class="lineno">  443</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00444" name="l00444"></a><span class="lineno">  444</span><span class="comment">   * An open-channel request out-message.  Together with that is stored a `Builder` into its metadata</span></div>
<div class="line"><a id="l00445" name="l00445"></a><span class="lineno">  445</span><span class="comment">   * sub-field as well as the already-prepared #Channel_obj, the local transport::Channel peer object in PEER state,</span></div>
<div class="line"><a id="l00446" name="l00446"></a><span class="lineno">  446</span><span class="comment">   * since on the server side it is our responsibility acquire the shared resources for both sides.</span></div>
<div class="line"><a id="l00447" name="l00447"></a><span class="lineno">  447</span><span class="comment">   *</span></div>
<div class="line"><a id="l00448" name="l00448"></a><span class="lineno">  448</span><span class="comment">   * The design here is identical to Client_session_impl::Open_channel_req; so see its doc header.  The only</span></div>
<div class="line"><a id="l00449" name="l00449"></a><span class="lineno">  449</span><span class="comment">   * difference is the addition of #m_opened_channel; see its doc header just below.</span></div>
<div class="line"><a id="l00450" name="l00450"></a><span class="lineno">  450</span><span class="comment">   */</span></div>
<div class="line"><a id="l00451" name="l00451"></a><span class="lineno"><a class="line" href="structipc_1_1session_1_1Server__session__impl_1_1Open__channel__req.html">  451</a></span>  <span class="keyword">struct </span><a class="code hl_struct" href="structipc_1_1session_1_1Server__session__impl_1_1Open__channel__req.html">Open_channel_req</a></div>
<div class="line"><a id="l00452" name="l00452"></a><span class="lineno">  452</span>  {<span class="comment"></span></div>
<div class="line"><a id="l00453" name="l00453"></a><span class="lineno">  453</span><span class="comment">    /// See Client_session_impl::Master_channel_req::m_mdt_builder.</span></div>
<div class="line"><a id="l00454" name="l00454"></a><span class="lineno"><a class="line" href="structipc_1_1session_1_1Server__session__impl_1_1Open__channel__req.html#aa1a85c280c8144f3dfd4ba069de2eb0a">  454</a></span><span class="comment"></span>    <span class="keyword">typename</span> Mdt_builder_ptr::element_type <a class="code hl_variable" href="structipc_1_1session_1_1Server__session__impl_1_1Open__channel__req.html#aa1a85c280c8144f3dfd4ba069de2eb0a">m_mdt_builder</a>;<span class="comment"></span></div>
<div class="line"><a id="l00455" name="l00455"></a><span class="lineno">  455</span><span class="comment">    /// See Client_session_impl::Master_channel_req::m_req_msg.</span></div>
<div class="line"><a id="l00456" name="l00456"></a><span class="lineno"><a class="line" href="structipc_1_1session_1_1Server__session__impl_1_1Open__channel__req.html#a522e6691e46f956648c64877b64d6219">  456</a></span><span class="comment"></span>    <span class="keyword">typename</span> Master_structured_channel::Msg_out <a class="code hl_variable" href="structipc_1_1session_1_1Server__session__impl_1_1Open__channel__req.html#a522e6691e46f956648c64877b64d6219">m_req_msg</a>;</div>
<div class="line"><a id="l00457" name="l00457"></a><span class="lineno">  457</span><span class="comment"></span> </div>
<div class="line"><a id="l00458" name="l00458"></a><span class="lineno">  458</span><span class="comment">    /**</span></div>
<div class="line"><a id="l00459" name="l00459"></a><span class="lineno">  459</span><span class="comment">     * The transport::Channel, including the needed shared resources acquired, from</span></div>
<div class="line"><a id="l00460" name="l00460"></a><span class="lineno">  460</span><span class="comment">     * Server_session_impl::mdt_builder(); or a default-cted such object if that method failed to</span></div>
<div class="line"><a id="l00461" name="l00461"></a><span class="lineno">  461</span><span class="comment">     * acquire the needed resources (e.g., MQs).  To test for that failure simply check</span></div>
<div class="line"><a id="l00462" name="l00462"></a><span class="lineno">  462</span><span class="comment">     * transport::Channel::initialized().</span></div>
<div class="line"><a id="l00463" name="l00463"></a><span class="lineno">  463</span><span class="comment">     */</span></div>
<div class="line"><a id="l00464" name="l00464"></a><span class="lineno"><a class="line" href="structipc_1_1session_1_1Server__session__impl_1_1Open__channel__req.html#af46d9d419a695676703311def193044d">  464</a></span>    <a class="code hl_typedef" href="classipc_1_1session_1_1Server__session__impl.html#a7c969c3a1007f8e4ba3ad1c1acd6c290">Channel_obj</a> <a class="code hl_variable" href="structipc_1_1session_1_1Server__session__impl_1_1Open__channel__req.html#af46d9d419a695676703311def193044d">m_opened_channel</a>;</div>
<div class="line"><a id="l00465" name="l00465"></a><span class="lineno">  465</span>  }; <span class="comment">// struct Open_channel_req</span></div>
<div class="line"><a id="l00466" name="l00466"></a><span class="lineno">  466</span><span class="comment"></span> </div>
<div class="line"><a id="l00467" name="l00467"></a><span class="lineno">  467</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00468" name="l00468"></a><span class="lineno">  468</span><span class="comment">   * Short-hand for ref-counted pointer to Open_channel_req.</span></div>
<div class="line"><a id="l00469" name="l00469"></a><span class="lineno">  469</span><span class="comment">   * @see Client_session_impl::Open_channel_req doc header for info on the true nature of such `shared_ptr` as</span></div>
<div class="line"><a id="l00470" name="l00470"></a><span class="lineno">  470</span><span class="comment">   *      returned by us.</span></div>
<div class="line"><a id="l00471" name="l00471"></a><span class="lineno">  471</span><span class="comment">   */</span></div>
<div class="line"><a id="l00472" name="l00472"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#ade0880c766185ca00d12c908c3ddd3ed">  472</a></span>  <span class="keyword">using </span><a class="code hl_typedef" href="classipc_1_1session_1_1Server__session__impl.html#ade0880c766185ca00d12c908c3ddd3ed">Open_channel_req_ptr</a> = boost::shared_ptr&lt;Open_channel_req&gt;;</div>
<div class="line"><a id="l00473" name="l00473"></a><span class="lineno">  473</span> </div>
<div class="line"><a id="l00474" name="l00474"></a><span class="lineno">  474</span>  <span class="comment">// Methods.</span></div>
<div class="line"><a id="l00475" name="l00475"></a><span class="lineno">  475</span><span class="comment"></span> </div>
<div class="line"><a id="l00476" name="l00476"></a><span class="lineno">  476</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00477" name="l00477"></a><span class="lineno">  477</span><span class="comment">   * Core of both init_handlers() overloads, to be invoked in thread W.</span></div>
<div class="line"><a id="l00478" name="l00478"></a><span class="lineno">  478</span><span class="comment">   *</span></div>
<div class="line"><a id="l00479" name="l00479"></a><span class="lineno">  479</span><span class="comment">   * @param on_err_func_arg</span></div>
<div class="line"><a id="l00480" name="l00480"></a><span class="lineno">  480</span><span class="comment">   *        See init_handlers().  Concretely-typed version of that arg.</span></div>
<div class="line"><a id="l00481" name="l00481"></a><span class="lineno">  481</span><span class="comment">   * @param on_passive_open_channel_func_or_empty_arg</span></div>
<div class="line"><a id="l00482" name="l00482"></a><span class="lineno">  482</span><span class="comment">   *        See init_handlers().  Concretely-typed version of that arg; or `.empty()` one if the</span></div>
<div class="line"><a id="l00483" name="l00483"></a><span class="lineno">  483</span><span class="comment">   *        passive-opens-disabled overload was called.</span></div>
<div class="line"><a id="l00484" name="l00484"></a><span class="lineno">  484</span><span class="comment">   * @return See init_handlers().</span></div>
<div class="line"><a id="l00485" name="l00485"></a><span class="lineno">  485</span><span class="comment">   */</span></div>
<div class="line"><a id="l00486" name="l00486"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#ad39cb95f2e546cf5be927dfc295306c1">  486</a></span>  <span class="keywordtype">bool</span> <a class="code hl_function" href="classipc_1_1session_1_1Server__session__impl.html#ad39cb95f2e546cf5be927dfc295306c1">init_handlers_impl</a>(flow::async::Task_asio_err&amp;&amp; on_err_func_arg,</div>
<div class="line"><a id="l00487" name="l00487"></a><span class="lineno">  487</span>                          <a class="code hl_typedef" href="classipc_1_1session_1_1Session__base.html#a3c0824a54ef32915c5c5ea76481f2409">On_passive_open_channel_func</a>&amp;&amp; on_passive_open_channel_func_or_empty_arg);</div>
<div class="line"><a id="l00488" name="l00488"></a><span class="lineno">  488</span><span class="comment"></span> </div>
<div class="line"><a id="l00489" name="l00489"></a><span class="lineno">  489</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00490" name="l00490"></a><span class="lineno">  490</span><span class="comment">   * In thread W, returns whether init_handlers_impl() has yet executed.  This shall be checked in the thread-W</span></div>
<div class="line"><a id="l00491" name="l00491"></a><span class="lineno">  491</span><span class="comment">   * body of ~all APIs in this class.</span></div>
<div class="line"><a id="l00492" name="l00492"></a><span class="lineno">  492</span><span class="comment">   *</span></div>
<div class="line"><a id="l00493" name="l00493"></a><span class="lineno">  493</span><span class="comment">   * @return See above.</span></div>
<div class="line"><a id="l00494" name="l00494"></a><span class="lineno">  494</span><span class="comment">   */</span></div>
<div class="line"><a id="l00495" name="l00495"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#ae33e5c8ca6904844689e78ee764bc2da">  495</a></span>  <span class="keywordtype">bool</span> <a class="code hl_function" href="classipc_1_1session_1_1Server__session__impl.html#ae33e5c8ca6904844689e78ee764bc2da">handlers_are_set</a>() <span class="keyword">const</span>;</div>
<div class="line"><a id="l00496" name="l00496"></a><span class="lineno">  496</span><span class="comment"></span> </div>
<div class="line"><a id="l00497" name="l00497"></a><span class="lineno">  497</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00498" name="l00498"></a><span class="lineno">  498</span><span class="comment">   * In thread W, handler for #m_master_channel indicating incoming-direction channel-hosing error.</span></div>
<div class="line"><a id="l00499" name="l00499"></a><span class="lineno">  499</span><span class="comment">   * It is possible that #m_master_channel has been `.reset()` in the meantime, by seeing log-in failure</span></div>
<div class="line"><a id="l00500" name="l00500"></a><span class="lineno">  500</span><span class="comment">   * in on_master_channel_open_channel_req(), and no longer exists.</span></div>
<div class="line"><a id="l00501" name="l00501"></a><span class="lineno">  501</span><span class="comment">   *</span></div>
<div class="line"><a id="l00502" name="l00502"></a><span class="lineno">  502</span><span class="comment">   * @param err_code</span></div>
<div class="line"><a id="l00503" name="l00503"></a><span class="lineno">  503</span><span class="comment">   *        The non-success #Error_code from transport::struc::Channel.</span></div>
<div class="line"><a id="l00504" name="l00504"></a><span class="lineno">  504</span><span class="comment">   */</span></div>
<div class="line"><a id="l00505" name="l00505"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#aeccf8c9a6774d25bd4274962d69fc0e9">  505</a></span>  <span class="keywordtype">void</span> <a class="code hl_function" href="classipc_1_1session_1_1Server__session__impl.html#aeccf8c9a6774d25bd4274962d69fc0e9">on_master_channel_error</a>(<span class="keyword">const</span> <a class="code hl_typedef" href="namespaceipc.html#aa3192e586cc45d3e7c22463bf2760f89">Error_code</a>&amp; err_code);</div>
<div class="line"><a id="l00506" name="l00506"></a><span class="lineno">  506</span><span class="comment"></span> </div>
<div class="line"><a id="l00507" name="l00507"></a><span class="lineno">  507</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00508" name="l00508"></a><span class="lineno">  508</span><span class="comment">   * In thread W, handler for #m_master_channel receiving a passive-open (a/k/a open-channel-to-server) request.</span></div>
<div class="line"><a id="l00509" name="l00509"></a><span class="lineno">  509</span><span class="comment">   * If there is no issue with this request, and we&#39;re able to sync-send the open-channel response to that effect,</span></div>
<div class="line"><a id="l00510" name="l00510"></a><span class="lineno">  510</span><span class="comment">   * this shall fire on-passive-open handler, giving it a new #Channel_obj in PEER state + metadata.</span></div>
<div class="line"><a id="l00511" name="l00511"></a><span class="lineno">  511</span><span class="comment">   * If there is a problem, then it&#39;s not a session-hosing situation; local user is none-the-wiser; except that</span></div>
<div class="line"><a id="l00512" name="l00512"></a><span class="lineno">  512</span><span class="comment">   * if the `send()` reveals a *new* error, then it is a session-hosing situation, and local user is informed</span></div>
<div class="line"><a id="l00513" name="l00513"></a><span class="lineno">  513</span><span class="comment">   * via on-error handler.</span></div>
<div class="line"><a id="l00514" name="l00514"></a><span class="lineno">  514</span><span class="comment">   *</span></div>
<div class="line"><a id="l00515" name="l00515"></a><span class="lineno">  515</span><span class="comment">   * @param open_channel_req</span></div>
<div class="line"><a id="l00516" name="l00516"></a><span class="lineno">  516</span><span class="comment">   *        The request in-message from transport::struc::Channel.</span></div>
<div class="line"><a id="l00517" name="l00517"></a><span class="lineno">  517</span><span class="comment">   */</span></div>
<div class="line"><a id="l00518" name="l00518"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#a804c629b2da8898376f071db499a2173">  518</a></span>  <span class="keywordtype">void</span> <a class="code hl_function" href="classipc_1_1session_1_1Server__session__impl.html#a804c629b2da8898376f071db499a2173">on_master_channel_open_channel_req</a>(<span class="keyword">typename</span> <a class="code hl_typedef" href="classipc_1_1transport_1_1struc_1_1Channel.html#ae1f4b316eaeb7ed520a84d9e21e21063">Master_structured_channel::Msg_in_ptr</a>&amp;&amp; open_channel_req);</div>
<div class="line"><a id="l00519" name="l00519"></a><span class="lineno">  519</span><span class="comment"></span> </div>
<div class="line"><a id="l00520" name="l00520"></a><span class="lineno">  520</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00521" name="l00521"></a><span class="lineno">  521</span><span class="comment">   * In thread W acquires the needed shared sources (MQs and/or `Native_handle` pair as of this writing) and creates</span></div>
<div class="line"><a id="l00522" name="l00522"></a><span class="lineno">  522</span><span class="comment">   * local #Channel_obj to emit to the user thus completing the channel-open on this side.  If active-open on our part,</span></div>
<div class="line"><a id="l00523" name="l00523"></a><span class="lineno">  523</span><span class="comment">   * we do this immediately in mdt_builder() -- before open_channel() even -- but before the</span></div>
<div class="line"><a id="l00524" name="l00524"></a><span class="lineno">  524</span><span class="comment">   * #Channel_obj can be emitted to the user (1) open_channel() must actually be called (obv) and (2) client</span></div>
<div class="line"><a id="l00525" name="l00525"></a><span class="lineno">  525</span><span class="comment">   * must respond OK to our open-channel-to-client request out-message.  If passive-open, we do this upon receiving</span></div>
<div class="line"><a id="l00526" name="l00526"></a><span class="lineno">  526</span><span class="comment">   * client&#39;s open-channel-to-server request, before replying with our OK.  Either way we are the ones acquiring the</span></div>
<div class="line"><a id="l00527" name="l00527"></a><span class="lineno">  527</span><span class="comment">   * resources, then we send names/refs to those resources to client.</span></div>
<div class="line"><a id="l00528" name="l00528"></a><span class="lineno">  528</span><span class="comment">   *</span></div>
<div class="line"><a id="l00529" name="l00529"></a><span class="lineno">  529</span><span class="comment">   * Returns `false` if and only if could not acquire resources.</span></div>
<div class="line"><a id="l00530" name="l00530"></a><span class="lineno">  530</span><span class="comment">   *</span></div>
<div class="line"><a id="l00531" name="l00531"></a><span class="lineno">  531</span><span class="comment">   * @param mq_name_c2s_or_none_ptr</span></div>
<div class="line"><a id="l00532" name="l00532"></a><span class="lineno">  532</span><span class="comment">   *        If #S_MQS_ENABLED this out-arg is the (non-empty) name of the client-&gt;server unidirectional MQ for the</span></div>
<div class="line"><a id="l00533" name="l00533"></a><span class="lineno">  533</span><span class="comment">   *        channel.  Else ignored.  Must be empty at entry or behavior undefined (assertion may trip).</span></div>
<div class="line"><a id="l00534" name="l00534"></a><span class="lineno">  534</span><span class="comment">   * @param mq_name_s2c_or_none_ptr</span></div>
<div class="line"><a id="l00535" name="l00535"></a><span class="lineno">  535</span><span class="comment">   *        Like the preceding but opposite-direction (server-&gt;client).</span></div>
<div class="line"><a id="l00536" name="l00536"></a><span class="lineno">  536</span><span class="comment">   * @param remote_hndl_or_null_ptr</span></div>
<div class="line"><a id="l00537" name="l00537"></a><span class="lineno">  537</span><span class="comment">   *        If #S_SOCKET_STREAM_ENABLED this out-arg is the pre-connected `Native_handle` to send to the other</span></div>
<div class="line"><a id="l00538" name="l00538"></a><span class="lineno">  538</span><span class="comment">   *        side; we keep the other end and shove it into the #Channel_obj out-arg.  Else ignored.</span></div>
<div class="line"><a id="l00539" name="l00539"></a><span class="lineno">  539</span><span class="comment">   *        Must be `.null()` or behavior undefined (assertion may trip).</span></div>
<div class="line"><a id="l00540" name="l00540"></a><span class="lineno">  540</span><span class="comment">   * @param opened_channel_ptr</span></div>
<div class="line"><a id="l00541" name="l00541"></a><span class="lineno">  541</span><span class="comment">   *        Target #Channel_obj we shall try to move-to PEER state.  It&#39;ll be left unmodified if</span></div>
<div class="line"><a id="l00542" name="l00542"></a><span class="lineno">  542</span><span class="comment">   *        we return `false`.</span></div>
<div class="line"><a id="l00543" name="l00543"></a><span class="lineno">  543</span><span class="comment">   * @param active_else_passive</span></div>
<div class="line"><a id="l00544" name="l00544"></a><span class="lineno">  544</span><span class="comment">   *        `true` if this is from open_channel(); `false` if from on_master_channel_open_channel_req().</span></div>
<div class="line"><a id="l00545" name="l00545"></a><span class="lineno">  545</span><span class="comment">   * @return `true` on success; `false` if a resource could not be acquired.</span></div>
<div class="line"><a id="l00546" name="l00546"></a><span class="lineno">  546</span><span class="comment">   */</span></div>
<div class="line"><a id="l00547" name="l00547"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#a6f756d12f9e2b2cc3269564ba49bb354">  547</a></span>  <span class="keywordtype">bool</span> <a class="code hl_function" href="classipc_1_1session_1_1Server__session__impl.html#a6f756d12f9e2b2cc3269564ba49bb354">create_channel_and_resources</a>(<a class="code hl_class" href="classipc_1_1util_1_1Shared__name.html">Shared_name</a>* mq_name_c2s_or_none_ptr, <a class="code hl_class" href="classipc_1_1util_1_1Shared__name.html">Shared_name</a>* mq_name_s2c_or_none_ptr,</div>
<div class="line"><a id="l00548" name="l00548"></a><span class="lineno">  548</span>                                    <a class="code hl_struct" href="structipc_1_1util_1_1Native__handle.html">util::Native_handle</a>* remote_hndl_or_null_ptr, <a class="code hl_typedef" href="classipc_1_1session_1_1Session__base.html#a71f02a809d667c23ff8af29a96940bd1">Channel_obj</a>* opened_channel_ptr,</div>
<div class="line"><a id="l00549" name="l00549"></a><span class="lineno">  549</span>                                    <span class="keywordtype">bool</span> active_else_passive);</div>
<div class="line"><a id="l00550" name="l00550"></a><span class="lineno">  550</span><span class="comment"></span> </div>
<div class="line"><a id="l00551" name="l00551"></a><span class="lineno">  551</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00552" name="l00552"></a><span class="lineno">  552</span><span class="comment">   * Helper for create_channel_and_resources(), invoked and compiled if and only if #S_MQS_ENABLED, that *creates*</span></div>
<div class="line"><a id="l00553" name="l00553"></a><span class="lineno">  553</span><span class="comment">   * the underlying client-&gt;server and server-&gt;client MQs and local handles thereto, and outputs these things</span></div>
<div class="line"><a id="l00554" name="l00554"></a><span class="lineno">  554</span><span class="comment">   * via out-args.  On failure undoes everything it was able to do and returns `false`; else returns `true`.</span></div>
<div class="line"><a id="l00555" name="l00555"></a><span class="lineno">  555</span><span class="comment">   *</span></div>
<div class="line"><a id="l00556" name="l00556"></a><span class="lineno">  556</span><span class="comment">   * @param mq_c2s</span></div>
<div class="line"><a id="l00557" name="l00557"></a><span class="lineno">  557</span><span class="comment">   *        On success this is the handle to newly creates client-&gt;server unidirectional MQ for the new channel.</span></div>
<div class="line"><a id="l00558" name="l00558"></a><span class="lineno">  558</span><span class="comment">   * @param mq_s2c</span></div>
<div class="line"><a id="l00559" name="l00559"></a><span class="lineno">  559</span><span class="comment">   *        Like the preceding but opposite-direction (server-&gt;client).</span></div>
<div class="line"><a id="l00560" name="l00560"></a><span class="lineno">  560</span><span class="comment">   * @param mq_name_c2s</span></div>
<div class="line"><a id="l00561" name="l00561"></a><span class="lineno">  561</span><span class="comment">   *        Name for `mq_c2s`.</span></div>
<div class="line"><a id="l00562" name="l00562"></a><span class="lineno">  562</span><span class="comment">   * @param mq_name_s2c</span></div>
<div class="line"><a id="l00563" name="l00563"></a><span class="lineno">  563</span><span class="comment">   *        Name for `mq_s2c`.</span></div>
<div class="line"><a id="l00564" name="l00564"></a><span class="lineno">  564</span><span class="comment">   * @param err_code</span></div>
<div class="line"><a id="l00565" name="l00565"></a><span class="lineno">  565</span><span class="comment">   *        If `false` returned, this is the (truthy) reason code.</span></div>
<div class="line"><a id="l00566" name="l00566"></a><span class="lineno">  566</span><span class="comment">   * @return `true` on success; `false` on failure.</span></div>
<div class="line"><a id="l00567" name="l00567"></a><span class="lineno">  567</span><span class="comment">   */</span></div>
<div class="line"><a id="l00568" name="l00568"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#a84d54a57d3e06c064cde737d1f4be472">  568</a></span>  <span class="keywordtype">bool</span> <a class="code hl_function" href="classipc_1_1session_1_1Server__session__impl.html#a84d54a57d3e06c064cde737d1f4be472">make_channel_mqs</a>(<a class="code hl_typedef" href="classipc_1_1session_1_1Session__base.html#a848c0f5247644ada0f8b0ab816eedda8">Persistent_mq_handle_from_cfg</a>* mq_c2s,</div>
<div class="line"><a id="l00569" name="l00569"></a><span class="lineno">  569</span>                        <a class="code hl_typedef" href="classipc_1_1session_1_1Session__base.html#a848c0f5247644ada0f8b0ab816eedda8">Persistent_mq_handle_from_cfg</a>* mq_s2c,</div>
<div class="line"><a id="l00570" name="l00570"></a><span class="lineno">  570</span>                        <a class="code hl_class" href="classipc_1_1util_1_1Shared__name.html">Shared_name</a>* mq_name_c2s, <a class="code hl_class" href="classipc_1_1util_1_1Shared__name.html">Shared_name</a>* mq_name_s2c,</div>
<div class="line"><a id="l00571" name="l00571"></a><span class="lineno">  571</span>                        <a class="code hl_typedef" href="namespaceipc.html#aa3192e586cc45d3e7c22463bf2760f89">Error_code</a>* err_code);</div>
<div class="line"><a id="l00572" name="l00572"></a><span class="lineno">  572</span> </div>
<div class="line"><a id="l00573" name="l00573"></a><span class="lineno">  573</span>  <span class="comment">// Data.</span></div>
<div class="line"><a id="l00574" name="l00574"></a><span class="lineno">  574</span><span class="comment"></span> </div>
<div class="line"><a id="l00575" name="l00575"></a><span class="lineno">  575</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00576" name="l00576"></a><span class="lineno">  576</span><span class="comment">   * Handles the protocol negotiation at the start of the pipe, as pertains to algorithms perpetuated by</span></div>
<div class="line"><a id="l00577" name="l00577"></a><span class="lineno">  577</span><span class="comment">   * the vanilla ipc::session `Session` hierarchy.</span></div>
<div class="line"><a id="l00578" name="l00578"></a><span class="lineno">  578</span><span class="comment">   *</span></div>
<div class="line"><a id="l00579" name="l00579"></a><span class="lineno">  579</span><span class="comment">   * Outgoing-direction state is touched when assembling `LogInReq` to send to opposing `Server_session`.</span></div>
<div class="line"><a id="l00580" name="l00580"></a><span class="lineno">  580</span><span class="comment">   * Incoming-direction state is touched/verified at the start of interpreting `LogInRsp` receiver from there.</span></div>
<div class="line"><a id="l00581" name="l00581"></a><span class="lineno">  581</span><span class="comment">   *</span></div>
<div class="line"><a id="l00582" name="l00582"></a><span class="lineno">  582</span><span class="comment">   * @see transport::Protocol_negotiator doc header for key background on the topic.</span></div>
<div class="line"><a id="l00583" name="l00583"></a><span class="lineno">  583</span><span class="comment">   */</span></div>
<div class="line"><a id="l00584" name="l00584"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#aeca3e83ea5e99271ba928550ea4fb2d4">  584</a></span>  <a class="code hl_class" href="classipc_1_1transport_1_1Protocol__negotiator.html">transport::Protocol_negotiator</a> <a class="code hl_variable" href="classipc_1_1session_1_1Server__session__impl.html#aeca3e83ea5e99271ba928550ea4fb2d4">m_protocol_negotiator</a>;</div>
<div class="line"><a id="l00585" name="l00585"></a><span class="lineno">  585</span><span class="comment"></span> </div>
<div class="line"><a id="l00586" name="l00586"></a><span class="lineno">  586</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00587" name="l00587"></a><span class="lineno">  587</span><span class="comment">   * Analogous to #m_protocol_negotiator but pertains to algorithms perpetuated by (if relevant)</span></div>
<div class="line"><a id="l00588" name="l00588"></a><span class="lineno">  588</span><span class="comment">   * non-vanilla ipc::session `Session` hierarchy implemented on top of our vanilla ipc::session `Session` hierarchy.</span></div>
<div class="line"><a id="l00589" name="l00589"></a><span class="lineno">  589</span><span class="comment">   * For example, ipc::session::shm hierarchies can use this to version whatever additional protocol is required</span></div>
<div class="line"><a id="l00590" name="l00590"></a><span class="lineno">  590</span><span class="comment">   * to establish SHM things.</span></div>
<div class="line"><a id="l00591" name="l00591"></a><span class="lineno">  591</span><span class="comment">   *</span></div>
<div class="line"><a id="l00592" name="l00592"></a><span class="lineno">  592</span><span class="comment">   * @see transport::Protocol_negotiator doc header for key background on the topic.</span></div>
<div class="line"><a id="l00593" name="l00593"></a><span class="lineno">  593</span><span class="comment">   */</span></div>
<div class="line"><a id="l00594" name="l00594"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#a891c082930a837694606aff30c7026ed">  594</a></span>  <a class="code hl_class" href="classipc_1_1transport_1_1Protocol__negotiator.html">transport::Protocol_negotiator</a> <a class="code hl_variable" href="classipc_1_1session_1_1Server__session__impl.html#a891c082930a837694606aff30c7026ed">m_protocol_negotiator_aux</a>;</div>
<div class="line"><a id="l00595" name="l00595"></a><span class="lineno">  595</span><span class="comment"></span> </div>
<div class="line"><a id="l00596" name="l00596"></a><span class="lineno">  596</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00597" name="l00597"></a><span class="lineno">  597</span><span class="comment">   * The `on_done_func` argument to async_accept_log_in(); `.empty()` except while the (at most one, ever)</span></div>
<div class="line"><a id="l00598" name="l00598"></a><span class="lineno">  598</span><span class="comment">   * async_accept_log_in() is outstanding.  In other words it is assigned at entry at async_accept_log_in()</span></div>
<div class="line"><a id="l00599" name="l00599"></a><span class="lineno">  599</span><span class="comment">   * and `.clear()`ed upon being invoked, indicating either success or failure of the log-in.  Reminder:</span></div>
<div class="line"><a id="l00600" name="l00600"></a><span class="lineno">  600</span><span class="comment">   * async_accept_log_in() may not be re-attempted.</span></div>
<div class="line"><a id="l00601" name="l00601"></a><span class="lineno">  601</span><span class="comment">   *</span></div>
<div class="line"><a id="l00602" name="l00602"></a><span class="lineno">  602</span><span class="comment">   * It may be invoked by dtor, if it does not fire before dtor.</span></div>
<div class="line"><a id="l00603" name="l00603"></a><span class="lineno">  603</span><span class="comment">   */</span></div>
<div class="line"><a id="l00604" name="l00604"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#a59236329cf8e0f75c9ef628def1b97a7">  604</a></span>  flow::async::Task_asio_err <a class="code hl_variable" href="classipc_1_1session_1_1Server__session__impl.html#a59236329cf8e0f75c9ef628def1b97a7">m_log_in_on_done_func</a>;</div>
<div class="line"><a id="l00605" name="l00605"></a><span class="lineno">  605</span><span class="comment"></span> </div>
<div class="line"><a id="l00606" name="l00606"></a><span class="lineno">  606</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00607" name="l00607"></a><span class="lineno">  607</span><span class="comment">   * The pre-connected (PEER-state) socket stream peer; is non-as-if-default-cted only up to async_accept_log_in(),</span></div>
<div class="line"><a id="l00608" name="l00608"></a><span class="lineno">  608</span><span class="comment">   * at which point it is moved-to #m_master_channel.  Accessed only the one time, in async_accept_log_in(),</span></div>
<div class="line"><a id="l00609" name="l00609"></a><span class="lineno">  609</span><span class="comment">   * and immediately emptied there.  As of this writing that&#39;s in thread W, but that does not matter much.</span></div>
<div class="line"><a id="l00610" name="l00610"></a><span class="lineno">  610</span><span class="comment">   */</span></div>
<div class="line"><a id="l00611" name="l00611"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#a9be157fe8791e7be2dd43bd06480d3eb">  611</a></span>  <a class="code hl_class" href="classipc_1_1transport_1_1sync__io_1_1Native__socket__stream.html">transport::sync_io::Native_socket_stream</a> <a class="code hl_variable" href="classipc_1_1session_1_1Server__session__impl.html#a9be157fe8791e7be2dd43bd06480d3eb">m_master_sock_stm</a>;</div>
<div class="line"><a id="l00612" name="l00612"></a><span class="lineno">  612</span><span class="comment"></span> </div>
<div class="line"><a id="l00613" name="l00613"></a><span class="lineno">  613</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00614" name="l00614"></a><span class="lineno">  614</span><span class="comment">   * Unused/falsy except when in almost-PEER state (past successful async_accept_log_in(), before init_handlers()</span></div>
<div class="line"><a id="l00615" name="l00615"></a><span class="lineno">  615</span><span class="comment">   * invoked by user), and #m_master_channel reports incoming-direction error.  See class doc header for background.</span></div>
<div class="line"><a id="l00616" name="l00616"></a><span class="lineno">  616</span><span class="comment">   */</span></div>
<div class="line"><a id="l00617" name="l00617"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#ad9f6932719c1565191da73bfa4a3923f">  617</a></span>  <a class="code hl_typedef" href="namespaceipc.html#aa3192e586cc45d3e7c22463bf2760f89">Error_code</a> <a class="code hl_variable" href="classipc_1_1session_1_1Server__session__impl.html#ad9f6932719c1565191da73bfa4a3923f">m_pre_init_err_code</a>;</div>
<div class="line"><a id="l00618" name="l00618"></a><span class="lineno">  618</span><span class="comment"></span> </div>
<div class="line"><a id="l00619" name="l00619"></a><span class="lineno">  619</span><span class="comment">  /// Identical to Client_session_impl::m_last_passively_opened_channel_id.</span></div>
<div class="line"><a id="l00620" name="l00620"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#a869571c6ad3555df2396d561768b3f79">  620</a></span><span class="comment"></span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code hl_variable" href="classipc_1_1session_1_1Server__session__impl.html#a869571c6ad3555df2396d561768b3f79">m_last_passively_opened_channel_id</a>;</div>
<div class="line"><a id="l00621" name="l00621"></a><span class="lineno">  621</span><span class="comment"></span> </div>
<div class="line"><a id="l00622" name="l00622"></a><span class="lineno">  622</span><span class="comment">  /// Identical to Client_session_impl::m_last_actively_opened_channel_id.</span></div>
<div class="line"><a id="l00623" name="l00623"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#a6677dde04bab0c72881848a9b72a8227">  623</a></span><span class="comment"></span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code hl_variable" href="classipc_1_1session_1_1Server__session__impl.html#a6677dde04bab0c72881848a9b72a8227">m_last_actively_opened_channel_id</a>;</div>
<div class="line"><a id="l00624" name="l00624"></a><span class="lineno">  624</span><span class="comment"></span> </div>
<div class="line"><a id="l00625" name="l00625"></a><span class="lineno">  625</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00626" name="l00626"></a><span class="lineno">  626</span><span class="comment">   * Unique component of MQ names generated by make_channel_mqs() (if relevant; else untouched).</span></div>
<div class="line"><a id="l00627" name="l00627"></a><span class="lineno">  627</span><span class="comment">   * The mechanic of assigning this (1, 2, ...) is same as #m_last_passively_opened_channel_id.  Note, though,</span></div>
<div class="line"><a id="l00628" name="l00628"></a><span class="lineno">  628</span><span class="comment">   * this guy is very much not merely for logging: MQs must have unique names which are transmitted to the other</span></div>
<div class="line"><a id="l00629" name="l00629"></a><span class="lineno">  629</span><span class="comment">   * side during the channel-open procedure.</span></div>
<div class="line"><a id="l00630" name="l00630"></a><span class="lineno">  630</span><span class="comment">   */</span></div>
<div class="line"><a id="l00631" name="l00631"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#a54af1ca2d4e5485a2709f77d3f13635d">  631</a></span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code hl_variable" href="classipc_1_1session_1_1Server__session__impl.html#a54af1ca2d4e5485a2709f77d3f13635d">m_last_channel_mq_id</a>;</div>
<div class="line"><a id="l00632" name="l00632"></a><span class="lineno">  632</span><span class="comment"></span> </div>
<div class="line"><a id="l00633" name="l00633"></a><span class="lineno">  633</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00634" name="l00634"></a><span class="lineno">  634</span><span class="comment">   * Worker thread (a/k/a thread W).</span></div>
<div class="line"><a id="l00635" name="l00635"></a><span class="lineno">  635</span><span class="comment">   *</span></div>
<div class="line"><a id="l00636" name="l00636"></a><span class="lineno">  636</span><span class="comment">   * Ordering: Should be declared before #m_master_channel: It should destruct before the `Task_engine` onto which</span></div>
<div class="line"><a id="l00637" name="l00637"></a><span class="lineno">  637</span><span class="comment">   * its queued-up handlers might `post()` items destructs prematurely.</span></div>
<div class="line"><a id="l00638" name="l00638"></a><span class="lineno">  638</span><span class="comment">   *</span></div>
<div class="line"><a id="l00639" name="l00639"></a><span class="lineno">  639</span><span class="comment">   * ### Why `mutable`? ###</span></div>
<div class="line"><a id="l00640" name="l00640"></a><span class="lineno">  640</span><span class="comment">   * Well, session_token() is `const` to the user but must `.post()` which is non-`const`.  This fits the spirit</span></div>
<div class="line"><a id="l00641" name="l00641"></a><span class="lineno">  641</span><span class="comment">   * of `mutable`.  I (ygoldfel) think.</span></div>
<div class="line"><a id="l00642" name="l00642"></a><span class="lineno">  642</span><span class="comment">   */</span></div>
<div class="line"><a id="l00643" name="l00643"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#a73419b3ccb6e3d028d8acc8f9f42e0ac">  643</a></span>  <span class="keyword">mutable</span> flow::async::Single_thread_task_loop <a class="code hl_variable" href="classipc_1_1session_1_1Server__session__impl.html#a73419b3ccb6e3d028d8acc8f9f42e0ac">m_async_worker</a>;</div>
<div class="line"><a id="l00644" name="l00644"></a><span class="lineno">  644</span><span class="comment"></span> </div>
<div class="line"><a id="l00645" name="l00645"></a><span class="lineno">  645</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00646" name="l00646"></a><span class="lineno">  646</span><span class="comment">   * The session master channel.  Accessed in thread W only (not protected by mutex).</span></div>
<div class="line"><a id="l00647" name="l00647"></a><span class="lineno">  647</span><span class="comment">   *   - Up to async_accept_log_in(): this is null.</span></div>
<div class="line"><a id="l00648" name="l00648"></a><span class="lineno">  648</span><span class="comment">   *   - When async_accept_log_in() is outstanding: this is not null.</span></div>
<div class="line"><a id="l00649" name="l00649"></a><span class="lineno">  649</span><span class="comment">   *     - If it fails (and it cannot be re-attempted) it is renullified (though it could&#39;ve been left alone too;</span></div>
<div class="line"><a id="l00650" name="l00650"></a><span class="lineno">  650</span><span class="comment">   *       realistically dtor is coming soon... maybe reconsider that).</span></div>
<div class="line"><a id="l00651" name="l00651"></a><span class="lineno">  651</span><span class="comment">   *     - Otherwise it remains non-null and immutable until dtor.</span></div>
<div class="line"><a id="l00652" name="l00652"></a><span class="lineno">  652</span><span class="comment">   */</span></div>
<div class="line"><a id="l00653" name="l00653"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#a81eb6769bc75d900bb3c442047249503">  653</a></span>  <a class="code hl_typedef" href="classipc_1_1session_1_1Server__session__impl.html#ab6cfad1c0be9815dc5411cd20c131213">Master_structured_channel_ptr</a> <a class="code hl_variable" href="classipc_1_1session_1_1Server__session__impl.html#a81eb6769bc75d900bb3c442047249503">m_master_channel</a>;</div>
<div class="line"><a id="l00654" name="l00654"></a><span class="lineno">  654</span><span class="comment"></span> </div>
<div class="line"><a id="l00655" name="l00655"></a><span class="lineno">  655</span><span class="comment">  /// See sub_class_set_deinit_func().  `.empty()` unless that was called at least once.</span></div>
<div class="line"><a id="l00656" name="l00656"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#a02a0feffbe59da064cbf33ba33eb4dac">  656</a></span><span class="comment"></span>  <a class="code hl_typedef" href="namespaceipc.html#aa455c7f045059736578ca275fc1a851f">Function</a>&lt;void ()&gt; <a class="code hl_variable" href="classipc_1_1session_1_1Server__session__impl.html#a02a0feffbe59da064cbf33ba33eb4dac">m_deinit_func_or_empty</a>;</div>
<div class="line"><a id="l00657" name="l00657"></a><span class="lineno">  657</span><span class="comment"></span> </div>
<div class="line"><a id="l00658" name="l00658"></a><span class="lineno">  658</span><span class="comment">  /**</span></div>
<div class="line"><a id="l00659" name="l00659"></a><span class="lineno">  659</span><span class="comment">   * Null until PEER state is reached, and NULL unless compile-time #S_GRACEFUL_FINISH_REQUIRED is `true`,</span></div>
<div class="line"><a id="l00660" name="l00660"></a><span class="lineno">  660</span><span class="comment">   * this is used to block at the start of dtor to synchronize with the opposing `Session` dtor for safety.</span></div>
<div class="line"><a id="l00661" name="l00661"></a><span class="lineno">  661</span><span class="comment">   *</span></div>
<div class="line"><a id="l00662" name="l00662"></a><span class="lineno">  662</span><span class="comment">   * @see Session_base::Graceful_finisher doc header for all the background ever.</span></div>
<div class="line"><a id="l00663" name="l00663"></a><span class="lineno">  663</span><span class="comment">   */</span></div>
<div class="line"><a id="l00664" name="l00664"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#ac473cff436bde8b069a3f0d55d9c3b51">  664</a></span>  std::optional&lt;typename Base::Graceful_finisher&gt; <a class="code hl_variable" href="classipc_1_1session_1_1Server__session__impl.html#ac473cff436bde8b069a3f0d55d9c3b51">m_graceful_finisher</a>;</div>
<div class="line"><a id="l00665" name="l00665"></a><span class="lineno">  665</span>}; <span class="comment">// class Server_session_impl</span></div>
<div class="line"><a id="l00666" name="l00666"></a><span class="lineno">  666</span> </div>
<div class="line"><a id="l00667" name="l00667"></a><span class="lineno">  667</span><span class="comment">// Free functions: in *_fwd.hpp.</span></div>
<div class="line"><a id="l00668" name="l00668"></a><span class="lineno">  668</span> </div>
<div class="line"><a id="l00669" name="l00669"></a><span class="lineno">  669</span><span class="comment">// Template implementations.</span></div>
<div class="line"><a id="l00670" name="l00670"></a><span class="lineno">  670</span><span class="comment"></span> </div>
<div class="line"><a id="l00671" name="l00671"></a><span class="lineno">  671</span><span class="comment">/// Internally used macro; public API users should disregard (same deal as in struc/channel.hpp).</span></div>
<div class="line"><a id="l00672" name="l00672"></a><span class="lineno"><a class="line" href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp.html#aea842eaa966995a5ff8abf5672a25a5f">  672</a></span><span class="comment"></span><span class="preprocessor">#define TEMPLATE_SRV_SESSION_IMPL \</span></div>
<div class="line"><a id="l00673" name="l00673"></a><span class="lineno">  673</span><span class="preprocessor">  template&lt;schema::MqType S_MQ_TYPE_OR_NONE, bool S_TRANSMIT_NATIVE_HANDLES, typename Mdt_payload, \</span></div>
<div class="line"><a id="l00674" name="l00674"></a><span class="lineno">  674</span><span class="preprocessor">           schema::ShmType S_SHM_TYPE_OR_NONE, size_t S_SHM_MAX_HNDL_SZ, bool S_GRACEFUL_FINISH_REQUIRED_V&gt;</span><span class="comment"></span></div>
<div class="line"><a id="l00675" name="l00675"></a><span class="lineno">  675</span><span class="comment">/// Internally used macro; public API users should disregard (same deal as in struc/channel.hpp).</span></div>
<div class="line"><a id="l00676" name="l00676"></a><span class="lineno"><a class="line" href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp.html#a97654d0122c90a30b35a270e840ad9b7">  676</a></span><span class="comment"></span><span class="preprocessor">#define CLASS_SRV_SESSION_IMPL \</span></div>
<div class="line"><a id="l00677" name="l00677"></a><span class="lineno">  677</span><span class="preprocessor">  Server_session_impl&lt;S_MQ_TYPE_OR_NONE, S_TRANSMIT_NATIVE_HANDLES, Mdt_payload, \</span></div>
<div class="line"><a id="l00678" name="l00678"></a><span class="lineno">  678</span><span class="preprocessor">                      S_SHM_TYPE_OR_NONE, S_SHM_MAX_HNDL_SZ, S_GRACEFUL_FINISH_REQUIRED_V&gt;</span></div>
<div class="line"><a id="l00679" name="l00679"></a><span class="lineno">  679</span> </div>
<div class="line"><a id="l00680" name="l00680"></a><span class="lineno">  680</span><a class="code hl_define" href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp.html#aea842eaa966995a5ff8abf5672a25a5f">TEMPLATE_SRV_SESSION_IMPL</a></div>
<div class="line"><a id="l00681" name="l00681"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#a424215b95b49fea0b3b3986688395158">  681</a></span>CLASS_SRV_SESSION_IMPL::Server_session_impl(flow::log::Logger* logger_ptr, <span class="keyword">const</span> <a class="code hl_struct" href="structipc_1_1session_1_1Server__app.html">Server_app</a>&amp; srv_app_ref,</div>
<div class="line"><a id="l00682" name="l00682"></a><span class="lineno">  682</span>                                            <a class="code hl_class" href="classipc_1_1transport_1_1sync__io_1_1Native__socket__stream.html">transport::sync_io::Native_socket_stream</a>&amp;&amp; master_channel_sock_stm) :</div>
<div class="line"><a id="l00683" name="l00683"></a><span class="lineno">  683</span>  <a class="code hl_class" href="classipc_1_1session_1_1Session__base.html">Base</a>(srv_app_ref),</div>
<div class="line"><a id="l00684" name="l00684"></a><span class="lineno">  684</span>  flow::log::Log_context(logger_ptr, <a class="code hl_enumeration" href="namespaceipc.html#a4ccdeed058222c635745a4dc830e99f7">Log_component</a>::S_SESSION),</div>
<div class="line"><a id="l00685" name="l00685"></a><span class="lineno">  685</span> </div>
<div class="line"><a id="l00686" name="l00686"></a><span class="lineno">  686</span>  <span class="comment">/* Initial protocol = 1!</span></div>
<div class="line"><a id="l00687" name="l00687"></a><span class="lineno">  687</span><span class="comment">   * @todo This will get quite a bit more complex, especially for m_protocol_negotiator_aux,</span></div>
<div class="line"><a id="l00688" name="l00688"></a><span class="lineno">  688</span><span class="comment">   *       once at least one relevant protocol gains a version 2.  See class doc header for discussion. */</span></div>
<div class="line"><a id="l00689" name="l00689"></a><span class="lineno">  689</span>  m_protocol_negotiator(get_logger(), flow::util::ostream_op_string(<span class="stringliteral">&quot;srv-sess-&quot;</span>, *this), 1, 1),</div>
<div class="line"><a id="l00690" name="l00690"></a><span class="lineno">  690</span>  m_protocol_negotiator_aux(get_logger(), flow::util::ostream_op_string(<span class="stringliteral">&quot;srv-sess-aux-&quot;</span>, *this), 1, 1),</div>
<div class="line"><a id="l00691" name="l00691"></a><span class="lineno">  691</span> </div>
<div class="line"><a id="l00692" name="l00692"></a><span class="lineno">  692</span>  m_master_sock_stm(std::move(master_channel_sock_stm)),</div>
<div class="line"><a id="l00693" name="l00693"></a><span class="lineno">  693</span>  m_last_passively_opened_channel_id(0),</div>
<div class="line"><a id="l00694" name="l00694"></a><span class="lineno">  694</span>  m_last_actively_opened_channel_id(0),</div>
<div class="line"><a id="l00695" name="l00695"></a><span class="lineno">  695</span>  m_last_channel_mq_id(0),</div>
<div class="line"><a id="l00696" name="l00696"></a><span class="lineno">  696</span>  m_async_worker(get_logger(), flow::util::ostream_op_string(<span class="stringliteral">&quot;srv_sess[&quot;</span>, *this, <span class="stringliteral">&#39;]&#39;</span>))</div>
<div class="line"><a id="l00697" name="l00697"></a><span class="lineno">  697</span>{</div>
<div class="line"><a id="l00698" name="l00698"></a><span class="lineno">  698</span>  <span class="comment">/* Accept succeeded.  We have pretty much all we need for the Channel m_master_channel.  For simplicity</span></div>
<div class="line"><a id="l00699" name="l00699"></a><span class="lineno">  699</span><span class="comment">   * w/r/t handling errors delay that until the async_accept_log_in() though. */</span></div>
<div class="line"><a id="l00700" name="l00700"></a><span class="lineno">  700</span> </div>
<div class="line"><a id="l00701" name="l00701"></a><span class="lineno">  701</span>  FLOW_LOG_TRACE(<span class="stringliteral">&quot;Server session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Created.  The accept-log-in attempt not yet requested.  &quot;</span></div>
<div class="line"><a id="l00702" name="l00702"></a><span class="lineno">  702</span>                 <span class="stringliteral">&quot;Worker thread starting, will idle until accept-log-in.  We have the freshly-accepted &quot;</span></div>
<div class="line"><a id="l00703" name="l00703"></a><span class="lineno">  703</span>                 <span class="stringliteral">&quot;master socket stream [&quot;</span> &lt;&lt; <a class="code hl_variable" href="classipc_1_1session_1_1Server__session__impl.html#a9be157fe8791e7be2dd43bd06480d3eb">m_master_sock_stm</a> &lt;&lt; <span class="stringliteral">&quot;].&quot;</span>);</div>
<div class="line"><a id="l00704" name="l00704"></a><span class="lineno">  704</span>  <a class="code hl_variable" href="classipc_1_1session_1_1Server__session__impl.html#a73419b3ccb6e3d028d8acc8f9f42e0ac">m_async_worker</a>.start();</div>
<div class="line"><a id="l00705" name="l00705"></a><span class="lineno">  705</span>} <span class="comment">// Server_session_impl::Server_session_impl()</span></div>
<div class="line"><a id="l00706" name="l00706"></a><span class="lineno">  706</span> </div>
<div class="line"><a id="l00707" name="l00707"></a><span class="lineno">  707</span><a class="code hl_define" href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp.html#aea842eaa966995a5ff8abf5672a25a5f">TEMPLATE_SRV_SESSION_IMPL</a></div>
<div class="line"><a id="l00708" name="l00708"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#a28503a7c6622aacc7e08d4904da10da3">  708</a></span><span class="keywordtype">void</span> CLASS_SRV_SESSION_IMPL::dtor_async_worker_stop()</div>
<div class="line"><a id="l00709" name="l00709"></a><span class="lineno">  709</span>{</div>
<div class="line"><a id="l00710" name="l00710"></a><span class="lineno">  710</span>  <span class="keyword">using </span>flow::async::Synchronicity;</div>
<div class="line"><a id="l00711" name="l00711"></a><span class="lineno">  711</span>  <span class="keyword">using </span>boost::promise;</div>
<div class="line"><a id="l00712" name="l00712"></a><span class="lineno">  712</span> </div>
<div class="line"><a id="l00713" name="l00713"></a><span class="lineno">  713</span>  <span class="comment">// We are in thread U (from either our own dtor or subclass dtor).</span></div>
<div class="line"><a id="l00714" name="l00714"></a><span class="lineno">  714</span> </div>
<div class="line"><a id="l00715" name="l00715"></a><span class="lineno">  715</span>  assert((!m_async_worker.task_engine()-&gt;stopped()) &amp;&amp; <span class="stringliteral">&quot;This shall be called at most once.&quot;</span>);</div>
<div class="line"><a id="l00716" name="l00716"></a><span class="lineno">  716</span> </div>
<div class="line"><a id="l00717" name="l00717"></a><span class="lineno">  717</span>  <span class="comment">/* The following is quite similar to Client_session_impl::dtor_async_worker_stop(), so keeping comments</span></div>
<div class="line"><a id="l00718" name="l00718"></a><span class="lineno">  718</span><span class="comment">   * light here (@todo code reuse?). */</span></div>
<div class="line"><a id="l00719" name="l00719"></a><span class="lineno">  719</span> </div>
<div class="line"><a id="l00720" name="l00720"></a><span class="lineno">  720</span>  FLOW_LOG_INFO(<span class="stringliteral">&quot;Server session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Shutting down.  Worker thread will be joined, but first &quot;</span></div>
<div class="line"><a id="l00721" name="l00721"></a><span class="lineno">  721</span>                <span class="stringliteral">&quot;we perform session master channel end-sending op (flush outgoing data) until completion.  &quot;</span></div>
<div class="line"><a id="l00722" name="l00722"></a><span class="lineno">  722</span>                <span class="stringliteral">&quot;This is generally recommended at EOL of any struc::Channel, on error or otherwise.  &quot;</span></div>
<div class="line"><a id="l00723" name="l00723"></a><span class="lineno">  723</span>                <span class="stringliteral">&quot;This is technically blocking but unlikely to take long.  Also a Graceful_finisher phase may &quot;</span></div>
<div class="line"><a id="l00724" name="l00724"></a><span class="lineno">  724</span>                <span class="stringliteral">&quot;precede the above steps (it will log if so).&quot;</span>);</div>
<div class="line"><a id="l00725" name="l00725"></a><span class="lineno">  725</span> </div>
<div class="line"><a id="l00726" name="l00726"></a><span class="lineno">  726</span>  <span class="keywordflow">if</span> <span class="keyword">constexpr</span>(S_GRACEFUL_FINISH_REQUIRED)</div>
<div class="line"><a id="l00727" name="l00727"></a><span class="lineno">  727</span>  {</div>
<div class="line"><a id="l00728" name="l00728"></a><span class="lineno">  728</span>    <span class="keyword">typename</span> <a class="code hl_class" href="classipc_1_1session_1_1Session__base_1_1Graceful__finisher.html">Base::Graceful_finisher</a>* graceful_finisher_or_null = {};</div>
<div class="line"><a id="l00729" name="l00729"></a><span class="lineno">  729</span>    m_async_worker.post([&amp;]() <span class="comment">// Have to access m_graceful_finisher (the optional&lt;&gt;) in thread W only.</span></div>
<div class="line"><a id="l00730" name="l00730"></a><span class="lineno">  730</span>    {</div>
<div class="line"><a id="l00731" name="l00731"></a><span class="lineno">  731</span>      <span class="comment">// We are in thread W.</span></div>
<div class="line"><a id="l00732" name="l00732"></a><span class="lineno">  732</span>      <span class="keywordflow">if</span> (m_graceful_finisher)</div>
<div class="line"><a id="l00733" name="l00733"></a><span class="lineno">  733</span>      {</div>
<div class="line"><a id="l00734" name="l00734"></a><span class="lineno">  734</span>        graceful_finisher_or_null = &amp;(m_graceful_finisher.value());</div>
<div class="line"><a id="l00735" name="l00735"></a><span class="lineno">  735</span>      }</div>
<div class="line"><a id="l00736" name="l00736"></a><span class="lineno">  736</span>    }, Synchronicity::S_ASYNC_AND_AWAIT_CONCURRENT_COMPLETION); <span class="comment">// m_async_worker.post()</span></div>
<div class="line"><a id="l00737" name="l00737"></a><span class="lineno">  737</span> </div>
<div class="line"><a id="l00738" name="l00738"></a><span class="lineno">  738</span>    <span class="comment">/* If graceful_finisher_or_null is not null, then we&#39;re definitely in PEER state, and this is irreversible;</span></div>
<div class="line"><a id="l00739" name="l00739"></a><span class="lineno">  739</span><span class="comment">     * so it&#39;s cool to -&gt;on_dtor_start() on it.  It&#39;ll block as needed, etc.</span></div>
<div class="line"><a id="l00740" name="l00740"></a><span class="lineno">  740</span><span class="comment">     *</span></div>
<div class="line"><a id="l00741" name="l00741"></a><span class="lineno">  741</span><span class="comment">     * If it *is* null:</span></div>
<div class="line"><a id="l00742" name="l00742"></a><span class="lineno">  742</span><span class="comment">     *   - If between the assignment above to null and the next statement, m_graceful_finisher did not become</span></div>
<div class="line"><a id="l00743" name="l00743"></a><span class="lineno">  743</span><span class="comment">     *     non-empty, then there&#39;s no controversy: It&#39;s still not in PEER state; and there&#39;s no reason to</span></div>
<div class="line"><a id="l00744" name="l00744"></a><span class="lineno">  744</span><span class="comment">     *     block dtor still.  So no need to do anything, and that&#39;s correct.  Can just continue.</span></div>
<div class="line"><a id="l00745" name="l00745"></a><span class="lineno">  745</span><span class="comment">     *   - If however in the last few microseconds (or w/e) indeed m_graceful_finisher</span></div>
<div class="line"><a id="l00746" name="l00746"></a><span class="lineno">  746</span><span class="comment">     *     has become non-empty, then now *this is in PEER state.  ...NOPE!  The only way that can happen</span></div>
<div class="line"><a id="l00747" name="l00747"></a><span class="lineno">  747</span><span class="comment">     *     for us -- unlike Client_session_impl as of this writing -- is via init_handlers(), which they user</span></div>
<div class="line"><a id="l00748" name="l00748"></a><span class="lineno">  748</span><span class="comment">     *     themselves must execute.  So actually graceful_finisher_or_null remains accurate from up above</span></div>
<div class="line"><a id="l00749" name="l00749"></a><span class="lineno">  749</span><span class="comment">     *     to the next statement.  */</span></div>
<div class="line"><a id="l00750" name="l00750"></a><span class="lineno">  750</span>    <span class="keywordflow">if</span> (graceful_finisher_or_null)</div>
<div class="line"><a id="l00751" name="l00751"></a><span class="lineno">  751</span>    {</div>
<div class="line"><a id="l00752" name="l00752"></a><span class="lineno">  752</span>      graceful_finisher_or_null-&gt;<a class="code hl_function" href="classipc_1_1session_1_1Session__base_1_1Graceful__finisher.html#af441f45ce1ed7b890c3ab77d959f8830">on_dtor_start</a>();</div>
<div class="line"><a id="l00753" name="l00753"></a><span class="lineno">  753</span>      <span class="comment">// OK, now safe (or as safe as we can guarantee) to blow *this&#39;s various parts away.</span></div>
<div class="line"><a id="l00754" name="l00754"></a><span class="lineno">  754</span>    }</div>
<div class="line"><a id="l00755" name="l00755"></a><span class="lineno">  755</span>  } <span class="comment">// if constexpr(S_GRACEFUL_FINISH_REQUIRED)</span></div>
<div class="line"><a id="l00756" name="l00756"></a><span class="lineno">  756</span> </div>
<div class="line"><a id="l00757" name="l00757"></a><span class="lineno">  757</span>  m_async_worker.post([&amp;]()</div>
<div class="line"><a id="l00758" name="l00758"></a><span class="lineno">  758</span>  {</div>
<div class="line"><a id="l00759" name="l00759"></a><span class="lineno">  759</span>    <span class="comment">// We are in thread W.</span></div>
<div class="line"><a id="l00760" name="l00760"></a><span class="lineno">  760</span> </div>
<div class="line"><a id="l00761" name="l00761"></a><span class="lineno">  761</span>    <span class="keywordflow">if</span> (!m_master_channel)</div>
<div class="line"><a id="l00762" name="l00762"></a><span class="lineno">  762</span>    {</div>
<div class="line"><a id="l00763" name="l00763"></a><span class="lineno">  763</span>      <span class="keywordflow">return</span>; <span class="comment">// Destroyed at early juncture (as of this writing).  Whatever; cool; nothing to flush anyway.</span></div>
<div class="line"><a id="l00764" name="l00764"></a><span class="lineno">  764</span>    }</div>
<div class="line"><a id="l00765" name="l00765"></a><span class="lineno">  765</span>    <span class="comment">// else</span></div>
<div class="line"><a id="l00766" name="l00766"></a><span class="lineno">  766</span> </div>
<div class="line"><a id="l00767" name="l00767"></a><span class="lineno">  767</span>    promise&lt;void&gt; done_promise;</div>
<div class="line"><a id="l00768" name="l00768"></a><span class="lineno">  768</span>    m_master_channel-&gt;async_end_sending([&amp;](<span class="keyword">const</span> <a class="code hl_typedef" href="namespaceipc.html#aa3192e586cc45d3e7c22463bf2760f89">Error_code</a>&amp;)</div>
<div class="line"><a id="l00769" name="l00769"></a><span class="lineno">  769</span>    {</div>
<div class="line"><a id="l00770" name="l00770"></a><span class="lineno">  770</span>      <span class="comment">// We are in thread Wc (unspecified, really struc::Channel async callback thread).</span></div>
<div class="line"><a id="l00771" name="l00771"></a><span class="lineno">  771</span>      FLOW_LOG_TRACE(<span class="stringliteral">&quot;Server session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Shutdown: master channel outgoing-direction flush finished.&quot;</span>);</div>
<div class="line"><a id="l00772" name="l00772"></a><span class="lineno">  772</span>      done_promise.set_value();</div>
<div class="line"><a id="l00773" name="l00773"></a><span class="lineno">  773</span>    }); <span class="comment">// Don&#39;t care if returned false and did nothing: cool then; did our best.</span></div>
<div class="line"><a id="l00774" name="l00774"></a><span class="lineno">  774</span>    <span class="comment">// Back here in thread W:</span></div>
<div class="line"><a id="l00775" name="l00775"></a><span class="lineno">  775</span>    done_promise.get_future().wait();</div>
<div class="line"><a id="l00776" name="l00776"></a><span class="lineno">  776</span>  }, Synchronicity::S_ASYNC_AND_AWAIT_CONCURRENT_COMPLETION); <span class="comment">// m_async_worker.post()</span></div>
<div class="line"><a id="l00777" name="l00777"></a><span class="lineno">  777</span>  <span class="comment">// Back here in thread U: done; yay.</span></div>
<div class="line"><a id="l00778" name="l00778"></a><span class="lineno">  778</span> </div>
<div class="line"><a id="l00779" name="l00779"></a><span class="lineno">  779</span>  m_async_worker.stop();</div>
<div class="line"><a id="l00780" name="l00780"></a><span class="lineno">  780</span>  <span class="comment">// Thread W has been joined.</span></div>
<div class="line"><a id="l00781" name="l00781"></a><span class="lineno">  781</span>} <span class="comment">// Server_session_impl::dtor_async_worker_stop()</span></div>
<div class="line"><a id="l00782" name="l00782"></a><span class="lineno">  782</span> </div>
<div class="line"><a id="l00783" name="l00783"></a><span class="lineno">  783</span><a class="code hl_define" href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp.html#aea842eaa966995a5ff8abf5672a25a5f">TEMPLATE_SRV_SESSION_IMPL</a></div>
<div class="line"><a id="l00784" name="l00784"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#a145389df1784d5242adf69e2cc9826cd">  784</a></span>CLASS_SRV_SESSION_IMPL::~Server_session_impl()</div>
<div class="line"><a id="l00785" name="l00785"></a><span class="lineno">  785</span>{</div>
<div class="line"><a id="l00786" name="l00786"></a><span class="lineno">  786</span>  <span class="keyword">using </span>flow::async::Single_thread_task_loop;</div>
<div class="line"><a id="l00787" name="l00787"></a><span class="lineno">  787</span>  <span class="keyword">using </span>flow::util::ostream_op_string;</div>
<div class="line"><a id="l00788" name="l00788"></a><span class="lineno">  788</span> </div>
<div class="line"><a id="l00789" name="l00789"></a><span class="lineno">  789</span>  <span class="comment">// We are in thread U.  By contract in doc header, they must not call us from a completion handler (thread W).</span></div>
<div class="line"><a id="l00790" name="l00790"></a><span class="lineno">  790</span> </div>
<div class="line"><a id="l00791" name="l00791"></a><span class="lineno">  791</span>  <span class="comment">/* The following is quite similar to ~Client_session_impl(), so keeping comments light here (@todo code reuse?).</span></div>
<div class="line"><a id="l00792" name="l00792"></a><span class="lineno">  792</span><span class="comment">   * This is simpler after the dtor_async_worker_stop() though; async_accept_log_in() is *not* a public API;</span></div>
<div class="line"><a id="l00793" name="l00793"></a><span class="lineno">  793</span><span class="comment">   * so things like calling it more than 1x, let alone while an async-accept-log-in is in progress, are simply</span></div>
<div class="line"><a id="l00794" name="l00794"></a><span class="lineno">  794</span><span class="comment">   * not allowed and treated as undefined behavior.  Hence there&#39;s no m_mutex/m_state about which to worry. */</span></div>
<div class="line"><a id="l00795" name="l00795"></a><span class="lineno">  795</span> </div>
<div class="line"><a id="l00796" name="l00796"></a><span class="lineno">  796</span>  <span class="keywordflow">if</span> (!m_async_worker.task_engine()-&gt;stopped())</div>
<div class="line"><a id="l00797" name="l00797"></a><span class="lineno">  797</span>  {</div>
<div class="line"><a id="l00798" name="l00798"></a><span class="lineno">  798</span>    dtor_async_worker_stop();</div>
<div class="line"><a id="l00799" name="l00799"></a><span class="lineno">  799</span>  }</div>
<div class="line"><a id="l00800" name="l00800"></a><span class="lineno">  800</span> </div>
<div class="line"><a id="l00801" name="l00801"></a><span class="lineno">  801</span>  <span class="keywordflow">if</span> (!m_log_in_on_done_func.empty())</div>
<div class="line"><a id="l00802" name="l00802"></a><span class="lineno">  802</span>  {</div>
<div class="line"><a id="l00803" name="l00803"></a><span class="lineno">  803</span>    FLOW_LOG_INFO(<span class="stringliteral">&quot;Server session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Continuing shutdown.  Next we will run user async-accept-log-in &quot;</span></div>
<div class="line"><a id="l00804" name="l00804"></a><span class="lineno">  804</span>                  <span class="stringliteral">&quot;handler from some other thread.  In this user thread we will await its completion and then return.&quot;</span>);</div>
<div class="line"><a id="l00805" name="l00805"></a><span class="lineno">  805</span> </div>
<div class="line"><a id="l00806" name="l00806"></a><span class="lineno">  806</span>    Single_thread_task_loop one_thread(get_logger(), ostream_op_string(<span class="stringliteral">&quot;srv_sess[&quot;</span>, *<span class="keyword">this</span>, <span class="stringliteral">&quot;]-temp_deinit&quot;</span>));</div>
<div class="line"><a id="l00807" name="l00807"></a><span class="lineno">  807</span>    one_thread.start([&amp;]()</div>
<div class="line"><a id="l00808" name="l00808"></a><span class="lineno">  808</span>    {</div>
<div class="line"><a id="l00809" name="l00809"></a><span class="lineno">  809</span>      FLOW_LOG_INFO(<span class="stringliteral">&quot;Server session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: In transient finisher thread: Shall run pending handler.&quot;</span>);</div>
<div class="line"><a id="l00810" name="l00810"></a><span class="lineno">  810</span> </div>
<div class="line"><a id="l00811" name="l00811"></a><span class="lineno">  811</span>      m_log_in_on_done_func(<a class="code hl_enumvalue" href="namespaceipc_1_1session_1_1error.html#a0708d4bec9ae853f4d7e3d7822fc8f2fafe29343445a7bf167cc186a44bd2c6ed">error::Code::S_OBJECT_SHUTDOWN_ABORTED_COMPLETION_HANDLER</a>);</div>
<div class="line"><a id="l00812" name="l00812"></a><span class="lineno">  812</span>      FLOW_LOG_TRACE(<span class="stringliteral">&quot;User async-accept-log-in handler finished.&quot;</span>);</div>
<div class="line"><a id="l00813" name="l00813"></a><span class="lineno">  813</span>    }); <span class="comment">// one_thread.start()</span></div>
<div class="line"><a id="l00814" name="l00814"></a><span class="lineno">  814</span>  } <span class="comment">// if (!m_log_in_on_done_func.empty())</span></div>
<div class="line"><a id="l00815" name="l00815"></a><span class="lineno">  815</span>  <span class="comment">// Here thread exits/joins synchronously.  Back in thread U:</span></div>
<div class="line"><a id="l00816" name="l00816"></a><span class="lineno">  816</span> </div>
<div class="line"><a id="l00817" name="l00817"></a><span class="lineno">  817</span>  <span class="comment">// Last thing!  See sub_class_set_deinit_func() doc header which will eventually lead you to a rationale comment.</span></div>
<div class="line"><a id="l00818" name="l00818"></a><span class="lineno">  818</span>  <span class="keywordflow">if</span> (!m_deinit_func_or_empty.empty())</div>
<div class="line"><a id="l00819" name="l00819"></a><span class="lineno">  819</span>  {</div>
<div class="line"><a id="l00820" name="l00820"></a><span class="lineno">  820</span>    FLOW_LOG_INFO(<span class="stringliteral">&quot;Server session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Continuing shutdown.  A sub-class desires final de-init &quot;</span></div>
<div class="line"><a id="l00821" name="l00821"></a><span class="lineno">  821</span>                  <span class="stringliteral">&quot;work, once everything else is stopped (might be persistent resource cleanup); invoking &quot;</span></div>
<div class="line"><a id="l00822" name="l00822"></a><span class="lineno">  822</span>                  <span class="stringliteral">&quot;synchronously.&quot;</span>);</div>
<div class="line"><a id="l00823" name="l00823"></a><span class="lineno">  823</span>    m_deinit_func_or_empty();</div>
<div class="line"><a id="l00824" name="l00824"></a><span class="lineno">  824</span>    FLOW_LOG_TRACE(<span class="stringliteral">&quot;De-init work finished.&quot;</span>);</div>
<div class="line"><a id="l00825" name="l00825"></a><span class="lineno">  825</span>  }</div>
<div class="line"><a id="l00826" name="l00826"></a><span class="lineno">  826</span>} <span class="comment">// Server_session_impl::~Server_session_impl()</span></div>
<div class="line"><a id="l00827" name="l00827"></a><span class="lineno">  827</span> </div>
<div class="line"><a id="l00828" name="l00828"></a><span class="lineno">  828</span><a class="code hl_define" href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp.html#aea842eaa966995a5ff8abf5672a25a5f">TEMPLATE_SRV_SESSION_IMPL</a></div>
<div class="line"><a id="l00829" name="l00829"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#a3deaeacf53a8fc63ed010394ef82c54c">  829</a></span><span class="keyword">const</span> <a class="code hl_struct" href="structipc_1_1session_1_1Client__app.html">Client_app</a>* CLASS_SRV_SESSION_IMPL::client_app()<span class="keyword"> const</span></div>
<div class="line"><a id="l00830" name="l00830"></a><span class="lineno">  830</span><span class="keyword"></span>{</div>
<div class="line"><a id="l00831" name="l00831"></a><span class="lineno">  831</span>  <span class="comment">// They are to invoke this only in almost-PEER or PEER state, at which point cli_app_ptr() is non-null + immutable.</span></div>
<div class="line"><a id="l00832" name="l00832"></a><span class="lineno">  832</span>  <span class="keywordflow">return</span> Base::cli_app_ptr();</div>
<div class="line"><a id="l00833" name="l00833"></a><span class="lineno">  833</span>}</div>
<div class="line"><a id="l00834" name="l00834"></a><span class="lineno">  834</span> </div>
<div class="line"><a id="l00835" name="l00835"></a><span class="lineno">  835</span><a class="code hl_define" href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp.html#aea842eaa966995a5ff8abf5672a25a5f">TEMPLATE_SRV_SESSION_IMPL</a></div>
<div class="line"><a id="l00836" name="l00836"></a><span class="lineno">  836</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span> Task_err, <span class="keyword">typename</span> On_passive_open_channel_handler&gt;</div>
<div class="line"><a id="l00837" name="l00837"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#ac93040ccdaf5a261a053a8b55bd2e14e">  837</a></span><span class="keywordtype">bool</span> CLASS_SRV_SESSION_IMPL::init_handlers(Task_err&amp;&amp; on_err_func_arg,</div>
<div class="line"><a id="l00838" name="l00838"></a><span class="lineno">  838</span>                                           On_passive_open_channel_handler&amp;&amp; on_passive_open_channel_func_arg)</div>
<div class="line"><a id="l00839" name="l00839"></a><span class="lineno">  839</span>{</div>
<div class="line"><a id="l00840" name="l00840"></a><span class="lineno">  840</span>  <span class="keyword">using </span>flow::async::Task_asio_err;</div>
<div class="line"><a id="l00841" name="l00841"></a><span class="lineno">  841</span>  <span class="keyword">using </span>flow::async::Synchronicity;</div>
<div class="line"><a id="l00842" name="l00842"></a><span class="lineno">  842</span> </div>
<div class="line"><a id="l00843" name="l00843"></a><span class="lineno">  843</span>  <span class="comment">// We are in thread U.</span></div>
<div class="line"><a id="l00844" name="l00844"></a><span class="lineno">  844</span> </div>
<div class="line"><a id="l00845" name="l00845"></a><span class="lineno">  845</span>  <span class="keywordtype">bool</span> result;</div>
<div class="line"><a id="l00846" name="l00846"></a><span class="lineno">  846</span>  m_async_worker.post([&amp;]()</div>
<div class="line"><a id="l00847" name="l00847"></a><span class="lineno">  847</span>  {</div>
<div class="line"><a id="l00848" name="l00848"></a><span class="lineno">  848</span>    <span class="comment">// We are in thread W.</span></div>
<div class="line"><a id="l00849" name="l00849"></a><span class="lineno">  849</span>    result = init_handlers_impl(Task_asio_err(std::move(on_err_func_arg)),</div>
<div class="line"><a id="l00850" name="l00850"></a><span class="lineno">  850</span>                                <a class="code hl_typedef" href="classipc_1_1session_1_1Server__session__impl.html#af8013f82c2441d07bc82eda7cc3ad835">On_passive_open_channel_func</a>(std::move(on_passive_open_channel_func_arg)));</div>
<div class="line"><a id="l00851" name="l00851"></a><span class="lineno">  851</span>  }, Synchronicity::S_ASYNC_AND_AWAIT_CONCURRENT_COMPLETION);</div>
<div class="line"><a id="l00852" name="l00852"></a><span class="lineno">  852</span>  <span class="keywordflow">return</span> result;</div>
<div class="line"><a id="l00853" name="l00853"></a><span class="lineno">  853</span>}</div>
<div class="line"><a id="l00854" name="l00854"></a><span class="lineno">  854</span> </div>
<div class="line"><a id="l00855" name="l00855"></a><span class="lineno">  855</span><a class="code hl_define" href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp.html#aea842eaa966995a5ff8abf5672a25a5f">TEMPLATE_SRV_SESSION_IMPL</a></div>
<div class="line"><a id="l00856" name="l00856"></a><span class="lineno">  856</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span> Task_err&gt;</div>
<div class="line"><a id="l00857" name="l00857"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#a493937b9737f1fc4803364c35ceae83e">  857</a></span><span class="keywordtype">bool</span> CLASS_SRV_SESSION_IMPL::init_handlers(Task_err&amp;&amp; on_err_func_arg)</div>
<div class="line"><a id="l00858" name="l00858"></a><span class="lineno">  858</span>{</div>
<div class="line"><a id="l00859" name="l00859"></a><span class="lineno">  859</span>  <span class="keyword">using </span>flow::async::Task_asio_err;</div>
<div class="line"><a id="l00860" name="l00860"></a><span class="lineno">  860</span>  <span class="keyword">using </span>flow::async::Synchronicity;</div>
<div class="line"><a id="l00861" name="l00861"></a><span class="lineno">  861</span> </div>
<div class="line"><a id="l00862" name="l00862"></a><span class="lineno">  862</span>  <span class="comment">// We are in thread U.</span></div>
<div class="line"><a id="l00863" name="l00863"></a><span class="lineno">  863</span> </div>
<div class="line"><a id="l00864" name="l00864"></a><span class="lineno">  864</span>  <span class="keywordtype">bool</span> result;</div>
<div class="line"><a id="l00865" name="l00865"></a><span class="lineno">  865</span>  m_async_worker.post([&amp;]()</div>
<div class="line"><a id="l00866" name="l00866"></a><span class="lineno">  866</span>  {</div>
<div class="line"><a id="l00867" name="l00867"></a><span class="lineno">  867</span>    <span class="comment">// We are in thread W.</span></div>
<div class="line"><a id="l00868" name="l00868"></a><span class="lineno">  868</span>    result = init_handlers_impl(Task_asio_err(std::move(on_err_func_arg)),</div>
<div class="line"><a id="l00869" name="l00869"></a><span class="lineno">  869</span>                                <a class="code hl_typedef" href="classipc_1_1session_1_1Server__session__impl.html#af8013f82c2441d07bc82eda7cc3ad835">On_passive_open_channel_func</a>());</div>
<div class="line"><a id="l00870" name="l00870"></a><span class="lineno">  870</span>  }, Synchronicity::S_ASYNC_AND_AWAIT_CONCURRENT_COMPLETION);</div>
<div class="line"><a id="l00871" name="l00871"></a><span class="lineno">  871</span>  <span class="keywordflow">return</span> result;</div>
<div class="line"><a id="l00872" name="l00872"></a><span class="lineno">  872</span>}</div>
<div class="line"><a id="l00873" name="l00873"></a><span class="lineno">  873</span> </div>
<div class="line"><a id="l00874" name="l00874"></a><span class="lineno">  874</span><a class="code hl_define" href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp.html#aea842eaa966995a5ff8abf5672a25a5f">TEMPLATE_SRV_SESSION_IMPL</a></div>
<div class="line"><a id="l00875" name="l00875"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#ad39cb95f2e546cf5be927dfc295306c1">  875</a></span><span class="keywordtype">bool</span> CLASS_SRV_SESSION_IMPL::init_handlers_impl</div>
<div class="line"><a id="l00876" name="l00876"></a><span class="lineno">  876</span>       (flow::async::Task_asio_err&amp;&amp; on_err_func_arg,</div>
<div class="line"><a id="l00877" name="l00877"></a><span class="lineno">  877</span>        <a class="code hl_typedef" href="classipc_1_1session_1_1Server__session__impl.html#af8013f82c2441d07bc82eda7cc3ad835">On_passive_open_channel_func</a>&amp;&amp; on_passive_open_channel_func_or_empty_arg)</div>
<div class="line"><a id="l00878" name="l00878"></a><span class="lineno">  878</span>{</div>
<div class="line"><a id="l00879" name="l00879"></a><span class="lineno">  879</span>  <span class="comment">// We are in thread W.</span></div>
<div class="line"><a id="l00880" name="l00880"></a><span class="lineno">  880</span> </div>
<div class="line"><a id="l00881" name="l00881"></a><span class="lineno">  881</span>  <span class="keywordflow">if</span> (handlers_are_set())</div>
<div class="line"><a id="l00882" name="l00882"></a><span class="lineno">  882</span>  {</div>
<div class="line"><a id="l00883" name="l00883"></a><span class="lineno">  883</span>    FLOW_LOG_WARNING(<span class="stringliteral">&quot;Server session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: User trying to proceed to PEER state by setting handlers; &quot;</span></div>
<div class="line"><a id="l00884" name="l00884"></a><span class="lineno">  884</span>                     <span class="stringliteral">&quot;but we are already in that state (handlers are set).  Ignoring.&quot;</span>);</div>
<div class="line"><a id="l00885" name="l00885"></a><span class="lineno">  885</span>    <span class="keywordflow">return</span> <span class="keyword">false</span>;</div>
<div class="line"><a id="l00886" name="l00886"></a><span class="lineno">  886</span>  }</div>
<div class="line"><a id="l00887" name="l00887"></a><span class="lineno">  887</span>  <span class="comment">// else</span></div>
<div class="line"><a id="l00888" name="l00888"></a><span class="lineno">  888</span> </div>
<div class="line"><a id="l00889" name="l00889"></a><span class="lineno">  889</span>  FLOW_LOG_INFO(<span class="stringliteral">&quot;Server session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: User trying to proceed to PEER state by setting handlers: &quot;</span></div>
<div class="line"><a id="l00890" name="l00890"></a><span class="lineno">  890</span>                <span class="stringliteral">&quot;Success.  Will emit any cached master-channel error ([&quot;</span> &lt;&lt; m_pre_init_err_code &lt;&lt; <span class="stringliteral">&quot;] &quot;</span></div>
<div class="line"><a id="l00891" name="l00891"></a><span class="lineno">  891</span>                <span class="stringliteral">&quot;[&quot;</span> &lt;&lt; m_pre_init_err_code.message() &lt;&lt; <span class="stringliteral">&quot;]).&quot;</span>);</div>
<div class="line"><a id="l00892" name="l00892"></a><span class="lineno">  892</span> </div>
<div class="line"><a id="l00893" name="l00893"></a><span class="lineno">  893</span>  Base::set_on_err_func(std::move(on_err_func_arg));</div>
<div class="line"><a id="l00894" name="l00894"></a><span class="lineno">  894</span>  Base::set_on_passive_open_channel_func(std::move(on_passive_open_channel_func_or_empty_arg));</div>
<div class="line"><a id="l00895" name="l00895"></a><span class="lineno">  895</span>  assert(handlers_are_set() &amp;&amp; <span class="stringliteral">&quot;We just set them....&quot;</span>);</div>
<div class="line"><a id="l00896" name="l00896"></a><span class="lineno">  896</span> </div>
<div class="line"><a id="l00897" name="l00897"></a><span class="lineno">  897</span>  <span class="keywordflow">if</span> (m_pre_init_err_code)</div>
<div class="line"><a id="l00898" name="l00898"></a><span class="lineno">  898</span>  {</div>
<div class="line"><a id="l00899" name="l00899"></a><span class="lineno">  899</span>    assert((!Base::hosed()) &amp;&amp; <span class="stringliteral">&quot;We only just entered PEER state.&quot;</span>);</div>
<div class="line"><a id="l00900" name="l00900"></a><span class="lineno">  900</span> </div>
<div class="line"><a id="l00901" name="l00901"></a><span class="lineno">  901</span>    <span class="comment">/* Post this asynchronously onto thread W, even though we are in W already, so that they don&#39;t delay our,</span></div>
<div class="line"><a id="l00902" name="l00902"></a><span class="lineno">  902</span><span class="comment">     * and therefore thread U caller&#39;s, return. */</span></div>
<div class="line"><a id="l00903" name="l00903"></a><span class="lineno">  903</span>    m_async_worker.post([<span class="keyword">this</span>]()</div>
<div class="line"><a id="l00904" name="l00904"></a><span class="lineno">  904</span>    {</div>
<div class="line"><a id="l00905" name="l00905"></a><span class="lineno">  905</span>      <span class="comment">// We are in thread W.</span></div>
<div class="line"><a id="l00906" name="l00906"></a><span class="lineno">  906</span> </div>
<div class="line"><a id="l00907" name="l00907"></a><span class="lineno">  907</span>      <span class="keywordflow">if</span> (Base::hosed())</div>
<div class="line"><a id="l00908" name="l00908"></a><span class="lineno">  908</span>      {</div>
<div class="line"><a id="l00909" name="l00909"></a><span class="lineno">  909</span>        FLOW_LOG_INFO(<span class="stringliteral">&quot;Server session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: We were about to fire cached error observed earlier &quot;</span></div>
<div class="line"><a id="l00910" name="l00910"></a><span class="lineno">  910</span>                      <span class="stringliteral">&quot;during the almost-PEER phase; but somehow *yet another* error condition hosed us during &quot;</span></div>
<div class="line"><a id="l00911" name="l00911"></a><span class="lineno">  911</span>                      <span class="stringliteral">&quot;the async-gap between that recent decision and this task executing in worker thread.  &quot;</span></div>
<div class="line"><a id="l00912" name="l00912"></a><span class="lineno">  912</span>                      <span class="stringliteral">&quot;It is hard to imagine what it could be, but it is not known to be a bug or problem.  &quot;</span></div>
<div class="line"><a id="l00913" name="l00913"></a><span class="lineno">  913</span>                      <span class="stringliteral">&quot;It is interesting enough for INFO log level though.  Recommend investigation.&quot;</span>);</div>
<div class="line"><a id="l00914" name="l00914"></a><span class="lineno">  914</span>      }</div>
<div class="line"><a id="l00915" name="l00915"></a><span class="lineno">  915</span>      <span class="keywordflow">else</span></div>
<div class="line"><a id="l00916" name="l00916"></a><span class="lineno">  916</span>      {</div>
<div class="line"><a id="l00917" name="l00917"></a><span class="lineno">  917</span>        Base::hose(m_pre_init_err_code);</div>
<div class="line"><a id="l00918" name="l00918"></a><span class="lineno">  918</span>      }</div>
<div class="line"><a id="l00919" name="l00919"></a><span class="lineno">  919</span>    });</div>
<div class="line"><a id="l00920" name="l00920"></a><span class="lineno">  920</span>    <span class="keywordflow">return</span> <span class="keyword">true</span>;</div>
<div class="line"><a id="l00921" name="l00921"></a><span class="lineno">  921</span>  }</div>
<div class="line"><a id="l00922" name="l00922"></a><span class="lineno">  922</span>  <span class="comment">// else if (!m_pre_init_err_code):</span></div>
<div class="line"><a id="l00923" name="l00923"></a><span class="lineno">  923</span> </div>
<div class="line"><a id="l00924" name="l00924"></a><span class="lineno">  924</span>  m_master_channel-&gt;expect_msgs(Master_structured_channel::Msg_which_in::OPEN_CHANNEL_TO_SERVER_REQ,</div>
<div class="line"><a id="l00925" name="l00925"></a><span class="lineno">  925</span>                                [<span class="keyword">this</span>](<span class="keyword">const</span> <span class="keyword">typename</span> Master_structured_channel::Msg_in_ptr&amp; open_channel_req_cref)</div>
<div class="line"><a id="l00926" name="l00926"></a><span class="lineno">  926</span>  {</div>
<div class="line"><a id="l00927" name="l00927"></a><span class="lineno">  927</span>    <span class="comment">// We are in thread Wc (unspecified, really struc::Channel async callback thread).</span></div>
<div class="line"><a id="l00928" name="l00928"></a><span class="lineno">  928</span>    m_async_worker.post([<span class="keyword">this</span>, open_channel_req = open_channel_req_cref]() <span class="keyword">mutable</span></div>
<div class="line"><a id="l00929" name="l00929"></a><span class="lineno">  929</span>    {</div>
<div class="line"><a id="l00930" name="l00930"></a><span class="lineno">  930</span>      <span class="comment">// We are in thread W.</span></div>
<div class="line"><a id="l00931" name="l00931"></a><span class="lineno">  931</span>      on_master_channel_open_channel_req(std::move(open_channel_req));</div>
<div class="line"><a id="l00932" name="l00932"></a><span class="lineno">  932</span>    });</div>
<div class="line"><a id="l00933" name="l00933"></a><span class="lineno">  933</span>  });</div>
<div class="line"><a id="l00934" name="l00934"></a><span class="lineno">  934</span> </div>
<div class="line"><a id="l00935" name="l00935"></a><span class="lineno">  935</span>  <span class="comment">// See Session_base::Graceful_finisher doc header for all the background ever.  Also: it logs as needed.</span></div>
<div class="line"><a id="l00936" name="l00936"></a><span class="lineno">  936</span>  <span class="keywordflow">if</span> <span class="keyword">constexpr</span>(S_GRACEFUL_FINISH_REQUIRED)</div>
<div class="line"><a id="l00937" name="l00937"></a><span class="lineno">  937</span>  {</div>
<div class="line"><a id="l00938" name="l00938"></a><span class="lineno">  938</span>    m_graceful_finisher.emplace(get_logger(), <span class="keyword">this</span>, &amp;m_async_worker, m_master_channel.get());</div>
<div class="line"><a id="l00939" name="l00939"></a><span class="lineno">  939</span>  }</div>
<div class="line"><a id="l00940" name="l00940"></a><span class="lineno">  940</span> </div>
<div class="line"><a id="l00941" name="l00941"></a><span class="lineno">  941</span>  <span class="keywordflow">return</span> <span class="keyword">true</span>;</div>
<div class="line"><a id="l00942" name="l00942"></a><span class="lineno">  942</span>} <span class="comment">// Server_session_impl::init_handlers_impl()</span></div>
<div class="line"><a id="l00943" name="l00943"></a><span class="lineno">  943</span> </div>
<div class="line"><a id="l00944" name="l00944"></a><span class="lineno">  944</span><a class="code hl_define" href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp.html#aea842eaa966995a5ff8abf5672a25a5f">TEMPLATE_SRV_SESSION_IMPL</a></div>
<div class="line"><a id="l00945" name="l00945"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#ae33e5c8ca6904844689e78ee764bc2da">  945</a></span><span class="keywordtype">bool</span> CLASS_SRV_SESSION_IMPL::handlers_are_set()<span class="keyword"> const</span></div>
<div class="line"><a id="l00946" name="l00946"></a><span class="lineno">  946</span><span class="keyword"></span>{</div>
<div class="line"><a id="l00947" name="l00947"></a><span class="lineno">  947</span>  <span class="keywordflow">return</span> Base::on_err_func_set();</div>
<div class="line"><a id="l00948" name="l00948"></a><span class="lineno">  948</span>}</div>
<div class="line"><a id="l00949" name="l00949"></a><span class="lineno">  949</span> </div>
<div class="line"><a id="l00950" name="l00950"></a><span class="lineno">  950</span><a class="code hl_define" href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp.html#aea842eaa966995a5ff8abf5672a25a5f">TEMPLATE_SRV_SESSION_IMPL</a></div>
<div class="line"><a id="l00951" name="l00951"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#a22e1464a8bc4b806bf3a91e932b31813">  951</a></span><span class="keyword">const</span> <a class="code hl_typedef" href="namespaceipc_1_1session.html#ade2b302f1a3623e8adc9694568d94d2c">Session_token</a>&amp; CLASS_SRV_SESSION_IMPL::session_token()<span class="keyword"> const</span></div>
<div class="line"><a id="l00952" name="l00952"></a><span class="lineno">  952</span><span class="keyword"></span>{</div>
<div class="line"><a id="l00953" name="l00953"></a><span class="lineno">  953</span>  <span class="keyword">using </span>flow::async::Synchronicity;</div>
<div class="line"><a id="l00954" name="l00954"></a><span class="lineno">  954</span> </div>
<div class="line"><a id="l00955" name="l00955"></a><span class="lineno">  955</span>  <span class="comment">// We are in thread U.</span></div>
<div class="line"><a id="l00956" name="l00956"></a><span class="lineno">  956</span> </div>
<div class="line"><a id="l00957" name="l00957"></a><span class="lineno">  957</span>  <span class="keyword">const</span> <a class="code hl_typedef" href="namespaceipc_1_1session.html#ade2b302f1a3623e8adc9694568d94d2c">Session_token</a>* result;</div>
<div class="line"><a id="l00958" name="l00958"></a><span class="lineno">  958</span>  m_async_worker.post([&amp;]()</div>
<div class="line"><a id="l00959" name="l00959"></a><span class="lineno">  959</span>  {</div>
<div class="line"><a id="l00960" name="l00960"></a><span class="lineno">  960</span>    <span class="comment">// We are in thread W.</span></div>
<div class="line"><a id="l00961" name="l00961"></a><span class="lineno">  961</span>    <span class="keywordflow">if</span> (!handlers_are_set())</div>
<div class="line"><a id="l00962" name="l00962"></a><span class="lineno">  962</span>    {</div>
<div class="line"><a id="l00963" name="l00963"></a><span class="lineno">  963</span>      FLOW_LOG_WARNING(<span class="stringliteral">&quot;Server session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Session-token accessor: Invoked before PEER state. &quot;</span></div>
<div class="line"><a id="l00964" name="l00964"></a><span class="lineno">  964</span>                       <span class="stringliteral">&quot;Returning null.&quot;</span>);</div>
<div class="line"><a id="l00965" name="l00965"></a><span class="lineno">  965</span>      result = &amp;<a class="code hl_variable" href="namespaceipc_1_1transport_1_1struc.html#ad556d20a2aa2d52b83c7afb73951d47d">transport::struc::NULL_SESSION_TOKEN</a>;</div>
<div class="line"><a id="l00966" name="l00966"></a><span class="lineno">  966</span>    }</div>
<div class="line"><a id="l00967" name="l00967"></a><span class="lineno">  967</span>    <span class="comment">// else</span></div>
<div class="line"><a id="l00968" name="l00968"></a><span class="lineno">  968</span> </div>
<div class="line"><a id="l00969" name="l00969"></a><span class="lineno">  969</span>    <span class="keywordflow">if</span> (Base::hosed())</div>
<div class="line"><a id="l00970" name="l00970"></a><span class="lineno">  970</span>    {</div>
<div class="line"><a id="l00971" name="l00971"></a><span class="lineno">  971</span>      FLOW_LOG_WARNING(<span class="stringliteral">&quot;Server session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Session-token accessor: Core executing after session &quot;</span></div>
<div class="line"><a id="l00972" name="l00972"></a><span class="lineno">  972</span>                       <span class="stringliteral">&quot;hosed.  Ignoring.&quot;</span>);</div>
<div class="line"><a id="l00973" name="l00973"></a><span class="lineno">  973</span>      result = &amp;(<a class="code hl_variable" href="namespaceipc_1_1transport_1_1struc.html#ad556d20a2aa2d52b83c7afb73951d47d">transport::struc::NULL_SESSION_TOKEN</a>);</div>
<div class="line"><a id="l00974" name="l00974"></a><span class="lineno">  974</span>      <span class="keywordflow">return</span>;</div>
<div class="line"><a id="l00975" name="l00975"></a><span class="lineno">  975</span>    }</div>
<div class="line"><a id="l00976" name="l00976"></a><span class="lineno">  976</span>    <span class="comment">// else</span></div>
<div class="line"><a id="l00977" name="l00977"></a><span class="lineno">  977</span> </div>
<div class="line"><a id="l00978" name="l00978"></a><span class="lineno">  978</span>    assert(m_master_channel);</div>
<div class="line"><a id="l00979" name="l00979"></a><span class="lineno">  979</span>    result = &amp;(m_master_channel-&gt;session_token());</div>
<div class="line"><a id="l00980" name="l00980"></a><span class="lineno">  980</span>  }, Synchronicity::S_ASYNC_AND_AWAIT_CONCURRENT_COMPLETION);</div>
<div class="line"><a id="l00981" name="l00981"></a><span class="lineno">  981</span>  <span class="keywordflow">return</span> *result;</div>
<div class="line"><a id="l00982" name="l00982"></a><span class="lineno">  982</span>} <span class="comment">// Server_session_impl::session_token()</span></div>
<div class="line"><a id="l00983" name="l00983"></a><span class="lineno">  983</span> </div>
<div class="line"><a id="l00984" name="l00984"></a><span class="lineno">  984</span><a class="code hl_define" href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp.html#aea842eaa966995a5ff8abf5672a25a5f">TEMPLATE_SRV_SESSION_IMPL</a></div>
<div class="line"><a id="l00985" name="l00985"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#a138956765a655240080491157f316167">  985</a></span><span class="keyword">typename</span> CLASS_SRV_SESSION_IMPL::Mdt_builder_ptr CLASS_SRV_SESSION_IMPL::mdt_builder()</div>
<div class="line"><a id="l00986" name="l00986"></a><span class="lineno">  986</span>{</div>
<div class="line"><a id="l00987" name="l00987"></a><span class="lineno">  987</span>  <span class="keyword">using </span><a class="code hl_struct" href="structipc_1_1util_1_1Native__handle.html">util::Native_handle</a>;</div>
<div class="line"><a id="l00988" name="l00988"></a><span class="lineno">  988</span>  <span class="keyword">using </span>flow::async::Synchronicity;</div>
<div class="line"><a id="l00989" name="l00989"></a><span class="lineno">  989</span>  <span class="keyword">namespace </span>asio_local = transport::asio_local_stream_socket;</div>
<div class="line"><a id="l00990" name="l00990"></a><span class="lineno">  990</span> </div>
<div class="line"><a id="l00991" name="l00991"></a><span class="lineno">  991</span>  <span class="comment">// We are in thread U.</span></div>
<div class="line"><a id="l00992" name="l00992"></a><span class="lineno">  992</span> </div>
<div class="line"><a id="l00993" name="l00993"></a><span class="lineno">  993</span>  <a class="code hl_typedef" href="classipc_1_1session_1_1Server__session__impl.html#a7c969c3a1007f8e4ba3ad1c1acd6c290">Channel_obj</a> opened_channel;</div>
<div class="line"><a id="l00994" name="l00994"></a><span class="lineno">  994</span>  <a class="code hl_typedef" href="namespaceipc_1_1transport.html#a7ee4551983d9df16ec16a3139bac50e8">Native_handle</a> remote_hndl_or_null;</div>
<div class="line"><a id="l00995" name="l00995"></a><span class="lineno">  995</span>  <a class="code hl_class" href="classipc_1_1util_1_1Shared__name.html">Shared_name</a> mq_name_c2s_or_none;</div>
<div class="line"><a id="l00996" name="l00996"></a><span class="lineno">  996</span>  <a class="code hl_class" href="classipc_1_1util_1_1Shared__name.html">Shared_name</a> mq_name_s2c_or_none;</div>
<div class="line"><a id="l00997" name="l00997"></a><span class="lineno">  997</span>  <span class="keywordtype">bool</span> resources_acquired_ok = <span class="keyword">false</span>;</div>
<div class="line"><a id="l00998" name="l00998"></a><span class="lineno">  998</span> </div>
<div class="line"><a id="l00999" name="l00999"></a><span class="lineno">  999</span>  <span class="keyword">typename</span> Master_structured_channel::Msg_out open_channel_req_msg;</div>
<div class="line"><a id="l01000" name="l01000"></a><span class="lineno"> 1000</span>  <span class="keywordtype">bool</span> open_channel_req_msg_inited = <span class="keyword">false</span>;</div>
<div class="line"><a id="l01001" name="l01001"></a><span class="lineno"> 1001</span>  m_async_worker.post([&amp;]()</div>
<div class="line"><a id="l01002" name="l01002"></a><span class="lineno"> 1002</span>  {</div>
<div class="line"><a id="l01003" name="l01003"></a><span class="lineno"> 1003</span>    <span class="comment">// We are in thread W: need to be to access m_master_channel and to call create_channel_and_resources().</span></div>
<div class="line"><a id="l01004" name="l01004"></a><span class="lineno"> 1004</span> </div>
<div class="line"><a id="l01005" name="l01005"></a><span class="lineno"> 1005</span>    <span class="keywordflow">if</span> (!handlers_are_set())</div>
<div class="line"><a id="l01006" name="l01006"></a><span class="lineno"> 1006</span>    {</div>
<div class="line"><a id="l01007" name="l01007"></a><span class="lineno"> 1007</span>      FLOW_LOG_WARNING(<span class="stringliteral">&quot;Server session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Channel open active request: Invoked before PEER state. &quot;</span></div>
<div class="line"><a id="l01008" name="l01008"></a><span class="lineno"> 1008</span>                       <span class="stringliteral">&quot;Ignoring.&quot;</span>);</div>
<div class="line"><a id="l01009" name="l01009"></a><span class="lineno"> 1009</span>      assert((!open_channel_req_msg_inited) &amp;&amp; <span class="stringliteral">&quot;Should have remained false as initialized.&quot;</span>);</div>
<div class="line"><a id="l01010" name="l01010"></a><span class="lineno"> 1010</span>      assert((remote_hndl_or_null.null()) &amp;&amp; <span class="stringliteral">&quot;Should have remained .null() as initialized.&quot;</span>);</div>
<div class="line"><a id="l01011" name="l01011"></a><span class="lineno"> 1011</span>      <span class="keywordflow">return</span>;</div>
<div class="line"><a id="l01012" name="l01012"></a><span class="lineno"> 1012</span>    }</div>
<div class="line"><a id="l01013" name="l01013"></a><span class="lineno"> 1013</span>    <span class="comment">// else</span></div>
<div class="line"><a id="l01014" name="l01014"></a><span class="lineno"> 1014</span> </div>
<div class="line"><a id="l01015" name="l01015"></a><span class="lineno"> 1015</span>    resources_acquired_ok</div>
<div class="line"><a id="l01016" name="l01016"></a><span class="lineno"> 1016</span>      = (!Base::hosed())</div>
<div class="line"><a id="l01017" name="l01017"></a><span class="lineno"> 1017</span>        &amp;&amp; create_channel_and_resources(&amp;mq_name_c2s_or_none, &amp;mq_name_s2c_or_none, &amp;remote_hndl_or_null,</div>
<div class="line"><a id="l01018" name="l01018"></a><span class="lineno"> 1018</span>                                        &amp;opened_channel, <span class="keyword">true</span>); <span class="comment">// true =&gt; active-open, not passive-open.</span></div>
<div class="line"><a id="l01019" name="l01019"></a><span class="lineno"> 1019</span> </div>
<div class="line"><a id="l01020" name="l01020"></a><span class="lineno"> 1020</span>    assert(resources_acquired_ok || remote_hndl_or_null.null());</div>
<div class="line"><a id="l01021" name="l01021"></a><span class="lineno"> 1021</span>    open_channel_req_msg = m_master_channel-&gt;create_msg(std::move(remote_hndl_or_null));</div>
<div class="line"><a id="l01022" name="l01022"></a><span class="lineno"> 1022</span>    open_channel_req_msg_inited = <span class="keyword">true</span>;</div>
<div class="line"><a id="l01023" name="l01023"></a><span class="lineno"> 1023</span>    <span class="comment">// (Might be sending them this Native_handle too. ---^)</span></div>
<div class="line"><a id="l01024" name="l01024"></a><span class="lineno"> 1024</span>  }, Synchronicity::S_ASYNC_AND_AWAIT_CONCURRENT_COMPLETION);</div>
<div class="line"><a id="l01025" name="l01025"></a><span class="lineno"> 1025</span> </div>
<div class="line"><a id="l01026" name="l01026"></a><span class="lineno"> 1026</span>  <span class="comment">// The rest we can do back in thread U again.</span></div>
<div class="line"><a id="l01027" name="l01027"></a><span class="lineno"> 1027</span> </div>
<div class="line"><a id="l01028" name="l01028"></a><span class="lineno"> 1028</span>  <span class="keywordflow">if</span> (!open_channel_req_msg_inited)</div>
<div class="line"><a id="l01029" name="l01029"></a><span class="lineno"> 1029</span>  {</div>
<div class="line"><a id="l01030" name="l01030"></a><span class="lineno"> 1030</span>    <span class="comment">// As advertised: Previous error (reported via on-error handler) =&gt; return null.</span></div>
<div class="line"><a id="l01031" name="l01031"></a><span class="lineno"> 1031</span>    <span class="keywordflow">return</span> <a class="code hl_typedef" href="classipc_1_1session_1_1Server__session__impl.html#ac4bc7e38574e0495af4887d2e6226b7a">Mdt_builder_ptr</a>();</div>
<div class="line"><a id="l01032" name="l01032"></a><span class="lineno"> 1032</span>  }</div>
<div class="line"><a id="l01033" name="l01033"></a><span class="lineno"> 1033</span>  <span class="comment">// else</span></div>
<div class="line"><a id="l01034" name="l01034"></a><span class="lineno"> 1034</span> </div>
<div class="line"><a id="l01035" name="l01035"></a><span class="lineno"> 1035</span>  <span class="keyword">auto</span> open_channel_root = open_channel_req_msg.body_root()-&gt;initOpenChannelToClientReq();</div>
<div class="line"><a id="l01036" name="l01036"></a><span class="lineno"> 1036</span>  <span class="keywordflow">if</span> (resources_acquired_ok)</div>
<div class="line"><a id="l01037" name="l01037"></a><span class="lineno"> 1037</span>  {</div>
<div class="line"><a id="l01038" name="l01038"></a><span class="lineno"> 1038</span>    open_channel_root.setClientToServerMqAbsNameOrEmpty(mq_name_c2s_or_none.<a class="code hl_function" href="classipc_1_1util_1_1Shared__name.html#ae89e1e061f87ffe0288514e254837595">str</a>());</div>
<div class="line"><a id="l01039" name="l01039"></a><span class="lineno"> 1039</span>    open_channel_root.setServerToClientMqAbsNameOrEmpty(mq_name_s2c_or_none.<a class="code hl_function" href="classipc_1_1util_1_1Shared__name.html#ae89e1e061f87ffe0288514e254837595">str</a>());</div>
<div class="line"><a id="l01040" name="l01040"></a><span class="lineno"> 1040</span>  }</div>
<div class="line"><a id="l01041" name="l01041"></a><span class="lineno"> 1041</span>  <span class="comment">/* else if (!resources_acquired_ok):</span></div>
<div class="line"><a id="l01042" name="l01042"></a><span class="lineno"> 1042</span><span class="comment">   * Resource unavailable.  Now, we know this already, even though we haven&#39;t even sent any request to the</span></div>
<div class="line"><a id="l01043" name="l01043"></a><span class="lineno"> 1043</span><span class="comment">   * client -- because we *are* the server and thus immediately can and must acquire the channel resources.</span></div>
<div class="line"><a id="l01044" name="l01044"></a><span class="lineno"> 1044</span><span class="comment">   * Our contract is to report such a problem via the later open_channel() though.  So we save this fact</span></div>
<div class="line"><a id="l01045" name="l01045"></a><span class="lineno"> 1045</span><span class="comment">   * and will report it quickly from open_channel(), right at its start.</span></div>
<div class="line"><a id="l01046" name="l01046"></a><span class="lineno"> 1046</span><span class="comment">   *</span></div>
<div class="line"><a id="l01047" name="l01047"></a><span class="lineno"> 1047</span><span class="comment">   * By saving a default-cted Channel_obj in this event, we indicate this fact.</span></div>
<div class="line"><a id="l01048" name="l01048"></a><span class="lineno"> 1048</span><span class="comment">   *</span></div>
<div class="line"><a id="l01049" name="l01049"></a><span class="lineno"> 1049</span><span class="comment">   * Rationale: Well, we promised this behavior.  But why?  We could report it now.  Answer: It would be a clumsy</span></div>
<div class="line"><a id="l01050" name="l01050"></a><span class="lineno"> 1050</span><span class="comment">   * API contract.  Either we must return `false`, in which case they cannot easily distinguish between</span></div>
<div class="line"><a id="l01051" name="l01051"></a><span class="lineno"> 1051</span><span class="comment">   * &quot;prior incoming-direction error =&gt; false, just count on the on-error handler&quot; and</span></div>
<div class="line"><a id="l01052" name="l01052"></a><span class="lineno"> 1052</span><span class="comment">   * &quot;resource unavailable error =&gt; false, your decision whether to blow everything up or what.&quot;;</span></div>
<div class="line"><a id="l01053" name="l01053"></a><span class="lineno"> 1053</span><span class="comment">   * or we&#39;d need to add an Error_code* out-arg, which means complicating the Session concept API, which means</span></div>
<div class="line"><a id="l01054" name="l01054"></a><span class="lineno"> 1054</span><span class="comment">   * changing Server_session too.  Anyway, it is weird, from user&#39;s PoV, to even deal with the idea that</span></div>
<div class="line"><a id="l01055" name="l01055"></a><span class="lineno"> 1055</span><span class="comment">   * in a Client_session the metadata-builder-returning method somehow can already fail -- they have no reason</span></div>
<div class="line"><a id="l01056" name="l01056"></a><span class="lineno"> 1056</span><span class="comment">   * to think resource acquisition occurs at that stage.  So at the expense of a short delay we just delegate</span></div>
<div class="line"><a id="l01057" name="l01057"></a><span class="lineno"> 1057</span><span class="comment">   * new-error reporting to open_channel() instead of making it an odd 2-step thing.</span></div>
<div class="line"><a id="l01058" name="l01058"></a><span class="lineno"> 1058</span><span class="comment">   *</span></div>
<div class="line"><a id="l01059" name="l01059"></a><span class="lineno"> 1059</span><span class="comment">   * That said, open_channel() contract still has to specifically note that the particular resource-unavailable</span></div>
<div class="line"><a id="l01060" name="l01060"></a><span class="lineno"> 1060</span><span class="comment">   * error -- not fatal to the Session -- is a possibility, unlike other `Error_code`s which are fatal.</span></div>
<div class="line"><a id="l01061" name="l01061"></a><span class="lineno"> 1061</span><span class="comment">   * However (1) that&#39;s open_channel()&#39;s problem; and (2) it is manageable (and is mandated by Session concept). */</span></div>
<div class="line"><a id="l01062" name="l01062"></a><span class="lineno"> 1062</span> </div>
<div class="line"><a id="l01063" name="l01063"></a><span class="lineno"> 1063</span>  <a class="code hl_typedef" href="classipc_1_1session_1_1Server__session__impl.html#ade0880c766185ca00d12c908c3ddd3ed">Open_channel_req_ptr</a> open_channel_req_ptr(<span class="keyword">new</span> <a class="code hl_struct" href="structipc_1_1session_1_1Server__session__impl_1_1Open__channel__req.html">Open_channel_req</a></div>
<div class="line"><a id="l01064" name="l01064"></a><span class="lineno"> 1064</span>                                                  { open_channel_root.initMetadata(),</div>
<div class="line"><a id="l01065" name="l01065"></a><span class="lineno"> 1065</span>                                                    std::move(open_channel_req_msg),</div>
<div class="line"><a id="l01066" name="l01066"></a><span class="lineno"> 1066</span>                                                    <span class="comment">// If this is empty: indicates resource-unavail eventuality.</span></div>
<div class="line"><a id="l01067" name="l01067"></a><span class="lineno"> 1067</span>                                                    resources_acquired_ok</div>
<div class="line"><a id="l01068" name="l01068"></a><span class="lineno"> 1068</span>                                                      ? std::move(opened_channel)</div>
<div class="line"><a id="l01069" name="l01069"></a><span class="lineno"> 1069</span>                                                      : <a class="code hl_typedef" href="classipc_1_1session_1_1Server__session__impl.html#a7c969c3a1007f8e4ba3ad1c1acd6c290">Channel_obj</a>() });</div>
<div class="line"><a id="l01070" name="l01070"></a><span class="lineno"> 1070</span>  <span class="keywordflow">return</span> <a class="code hl_typedef" href="classipc_1_1session_1_1Server__session__impl.html#ac4bc7e38574e0495af4887d2e6226b7a">Mdt_builder_ptr</a>(std::move(open_channel_req_ptr), &amp;open_channel_req_ptr-&gt;m_mdt_builder);</div>
<div class="line"><a id="l01071" name="l01071"></a><span class="lineno"> 1071</span>} <span class="comment">// Server_session_impl::mdt_builder()</span></div>
<div class="line"><a id="l01072" name="l01072"></a><span class="lineno"> 1072</span> </div>
<div class="line"><a id="l01073" name="l01073"></a><span class="lineno"> 1073</span><a class="code hl_define" href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp.html#aea842eaa966995a5ff8abf5672a25a5f">TEMPLATE_SRV_SESSION_IMPL</a></div>
<div class="line"><a id="l01074" name="l01074"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#a45a5ae92b706ea539c27be0d19a303c4"> 1074</a></span><span class="keywordtype">bool</span> CLASS_SRV_SESSION_IMPL::open_channel(<a class="code hl_typedef" href="classipc_1_1session_1_1Server__session__impl.html#a7c969c3a1007f8e4ba3ad1c1acd6c290">Channel_obj</a>* target_channel, <span class="keyword">const</span> <a class="code hl_typedef" href="classipc_1_1session_1_1Server__session__impl.html#ac4bc7e38574e0495af4887d2e6226b7a">Mdt_builder_ptr</a>&amp; mdt,</div>
<div class="line"><a id="l01075" name="l01075"></a><span class="lineno"> 1075</span>                                          <a class="code hl_typedef" href="namespaceipc.html#aa3192e586cc45d3e7c22463bf2760f89">Error_code</a>* err_code)</div>
<div class="line"><a id="l01076" name="l01076"></a><span class="lineno"> 1076</span>{</div>
<div class="line"><a id="l01077" name="l01077"></a><span class="lineno"> 1077</span>  <span class="keyword">using </span>schema::detail::OpenChannelResult;</div>
<div class="line"><a id="l01078" name="l01078"></a><span class="lineno"> 1078</span>  <span class="keyword">using </span>flow::async::Synchronicity;</div>
<div class="line"><a id="l01079" name="l01079"></a><span class="lineno"> 1079</span>  <span class="keyword">using </span>boost::chrono::milliseconds;</div>
<div class="line"><a id="l01080" name="l01080"></a><span class="lineno"> 1080</span>  <span class="keyword">using </span>boost::chrono::round;</div>
<div class="line"><a id="l01081" name="l01081"></a><span class="lineno"> 1081</span> </div>
<div class="line"><a id="l01082" name="l01082"></a><span class="lineno"> 1082</span>  <span class="comment">// We are in thread U.</span></div>
<div class="line"><a id="l01083" name="l01083"></a><span class="lineno"> 1083</span> </div>
<div class="line"><a id="l01084" name="l01084"></a><span class="lineno"> 1084</span>  FLOW_ERROR_EXEC_AND_THROW_ON_ERROR(<span class="keywordtype">bool</span>, <a class="code hl_function" href="classipc_1_1session_1_1Server__session__impl.html#a45a5ae92b706ea539c27be0d19a303c4">Server_session_impl::open_channel</a>,</div>
<div class="line"><a id="l01085" name="l01085"></a><span class="lineno"> 1085</span>                                     target_channel, flow::util::bind_ns::cref(mdt), _1);</div>
<div class="line"><a id="l01086" name="l01086"></a><span class="lineno"> 1086</span>  <span class="comment">// ^-- Call ourselves and return if err_code is null.  If got to present line, err_code is not null.</span></div>
<div class="line"><a id="l01087" name="l01087"></a><span class="lineno"> 1087</span> </div>
<div class="line"><a id="l01088" name="l01088"></a><span class="lineno"> 1088</span>  <span class="keywordflow">if</span> (!mdt)</div>
<div class="line"><a id="l01089" name="l01089"></a><span class="lineno"> 1089</span>  {</div>
<div class="line"><a id="l01090" name="l01090"></a><span class="lineno"> 1090</span>    FLOW_LOG_WARNING(<span class="stringliteral">&quot;Server session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Channel open active request: &quot;</span></div>
<div class="line"><a id="l01091" name="l01091"></a><span class="lineno"> 1091</span>                     <span class="stringliteral">&quot;null metadata-builder passed-in; either user error passing in null; or more likely &quot;</span></div>
<div class="line"><a id="l01092" name="l01092"></a><span class="lineno"> 1092</span>                     <span class="stringliteral">&quot;that routine failed and returned null, meaning an incoming-direction error was or is being &quot;</span></div>
<div class="line"><a id="l01093" name="l01093"></a><span class="lineno"> 1093</span>                     <span class="stringliteral">&quot;emitted to the on-error handler.  Emitting code-less failure in this synchronous path.&quot;</span>);</div>
<div class="line"><a id="l01094" name="l01094"></a><span class="lineno"> 1094</span>    <span class="keywordflow">return</span> <span class="keyword">false</span>;</div>
<div class="line"><a id="l01095" name="l01095"></a><span class="lineno"> 1095</span>  }</div>
<div class="line"><a id="l01096" name="l01096"></a><span class="lineno"> 1096</span>  <span class="comment">// else</span></div>
<div class="line"><a id="l01097" name="l01097"></a><span class="lineno"> 1097</span> </div>
<div class="line"><a id="l01098" name="l01098"></a><span class="lineno"> 1098</span>  <span class="comment">// See mdt_builder(): It may be indicating to us the resource-unavailable error.  Check for this.</span></div>
<div class="line"><a id="l01099" name="l01099"></a><span class="lineno"> 1099</span> </div>
<div class="line"><a id="l01100" name="l01100"></a><span class="lineno"> 1100</span>  <span class="keyword">auto</span>&amp; open_channel_req = *(<span class="keyword">reinterpret_cast&lt;</span><a class="code hl_struct" href="structipc_1_1session_1_1Server__session__impl_1_1Open__channel__req.html">Open_channel_req</a>*<span class="keyword">&gt;</span>(mdt.get()));</div>
<div class="line"><a id="l01101" name="l01101"></a><span class="lineno"> 1101</span>  <span class="keywordflow">if</span> (!open_channel_req.m_opened_channel.initialized())</div>
<div class="line"><a id="l01102" name="l01102"></a><span class="lineno"> 1102</span>  {</div>
<div class="line"><a id="l01103" name="l01103"></a><span class="lineno"> 1103</span>    <span class="comment">// @todo Maybe save the original Error_code responsible for this instead of emitting this catch-all thingie?</span></div>
<div class="line"><a id="l01104" name="l01104"></a><span class="lineno"> 1104</span>    *err_code = <a class="code hl_enumvalue" href="namespaceipc_1_1session_1_1error.html#a0708d4bec9ae853f4d7e3d7822fc8f2fa10d32cf1382fb003f09a6df2da408574">error::Code::S_SESSION_OPEN_CHANNEL_SERVER_CANNOT_PROCEED_RESOURCE_UNAVAILABLE</a>;</div>
<div class="line"><a id="l01105" name="l01105"></a><span class="lineno"> 1105</span>    FLOW_LOG_WARNING(<span class="stringliteral">&quot;Server session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Channel open active request: &quot;</span></div>
<div class="line"><a id="l01106" name="l01106"></a><span class="lineno"> 1106</span>                     <span class="stringliteral">&quot;metadata-builder indicates resources-unavailable error (not fatal to session).  Emitting error &quot;</span></div>
<div class="line"><a id="l01107" name="l01107"></a><span class="lineno"> 1107</span>                     <span class="stringliteral">&quot;[&quot;</span> &lt;&lt; *err_code &lt;&lt; <span class="stringliteral">&quot;] [&quot;</span> &lt;&lt; err_code-&gt;message() &lt;&lt; <span class="stringliteral">&quot;] without attempting any request to client.&quot;</span>);</div>
<div class="line"><a id="l01108" name="l01108"></a><span class="lineno"> 1108</span>    <span class="keywordflow">return</span> <span class="keyword">true</span>;</div>
<div class="line"><a id="l01109" name="l01109"></a><span class="lineno"> 1109</span>  }</div>
<div class="line"><a id="l01110" name="l01110"></a><span class="lineno"> 1110</span>  <span class="comment">// else</span></div>
<div class="line"><a id="l01111" name="l01111"></a><span class="lineno"> 1111</span> </div>
<div class="line"><a id="l01112" name="l01112"></a><span class="lineno"> 1112</span>  <span class="comment">// @todo The rest is way too similar to Client_session&#39;s.  Code reuse somehow?  Via Session_base perhaps?</span></div>
<div class="line"><a id="l01113" name="l01113"></a><span class="lineno"> 1113</span> </div>
<div class="line"><a id="l01114" name="l01114"></a><span class="lineno"> 1114</span>  FLOW_LOG_INFO(<span class="stringliteral">&quot;Server session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Channel open active request: The blocking, but presumed &quot;</span></div>
<div class="line"><a id="l01115" name="l01115"></a><span class="lineno"> 1115</span>                <span class="stringliteral">&quot;sufficiently quick to be considered non-blocking, request-response exchange initiating; timeout set &quot;</span></div>
<div class="line"><a id="l01116" name="l01116"></a><span class="lineno"> 1116</span>                <span class="stringliteral">&quot;to a generous [&quot;</span> &lt;&lt; round&lt;milliseconds&gt;(Base::S_OPEN_CHANNEL_TIMEOUT) &lt;&lt; <span class="stringliteral">&quot;].  The channel is already &quot;</span></div>
<div class="line"><a id="l01117" name="l01117"></a><span class="lineno"> 1117</span>                <span class="stringliteral">&quot;opened on our side: [&quot;</span> &lt;&lt; open_channel_req.m_opened_channel &lt;&lt; <span class="stringliteral">&quot;].&quot;</span>);</div>
<div class="line"><a id="l01118" name="l01118"></a><span class="lineno"> 1118</span> </div>
<div class="line"><a id="l01119" name="l01119"></a><span class="lineno"> 1119</span>  <span class="comment">/* As usual do all the work in thread W, where we can access m_master_channel and m_state among other things.</span></div>
<div class="line"><a id="l01120" name="l01120"></a><span class="lineno"> 1120</span><span class="comment">   * We do need to return the results of the operation here in thread U though. */</span></div>
<div class="line"><a id="l01121" name="l01121"></a><span class="lineno"> 1121</span>  <span class="keywordtype">bool</span> sync_error_but_do_not_emit = <span class="keyword">false</span>; <span class="comment">// If this ends up true, err_code is ignored and clear()ed ultimately.</span></div>
<div class="line"><a id="l01122" name="l01122"></a><span class="lineno"> 1122</span>  <span class="comment">// If it ends up false, *err_code will indicate either success or non-fatal error.</span></div>
<div class="line"><a id="l01123" name="l01123"></a><span class="lineno"> 1123</span> </div>
<div class="line"><a id="l01124" name="l01124"></a><span class="lineno"> 1124</span>  m_async_worker.post([&amp;]()</div>
<div class="line"><a id="l01125" name="l01125"></a><span class="lineno"> 1125</span>  {</div>
<div class="line"><a id="l01126" name="l01126"></a><span class="lineno"> 1126</span>    <span class="comment">// We are in thread W.</span></div>
<div class="line"><a id="l01127" name="l01127"></a><span class="lineno"> 1127</span> </div>
<div class="line"><a id="l01128" name="l01128"></a><span class="lineno"> 1128</span>    assert(handlers_are_set()</div>
<div class="line"><a id="l01129" name="l01129"></a><span class="lineno"> 1129</span>           &amp;&amp; <span class="stringliteral">&quot;mdt is non-null, yet state is not PEER, even though PEER is an end state?  Bug.&quot;</span>);</div>
<div class="line"><a id="l01130" name="l01130"></a><span class="lineno"> 1130</span> </div>
<div class="line"><a id="l01131" name="l01131"></a><span class="lineno"> 1131</span>    <span class="keywordflow">if</span> (Base::hosed())</div>
<div class="line"><a id="l01132" name="l01132"></a><span class="lineno"> 1132</span>    {</div>
<div class="line"><a id="l01133" name="l01133"></a><span class="lineno"> 1133</span>      FLOW_LOG_WARNING(<span class="stringliteral">&quot;Server session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Channel open request send-request stage preempted &quot;</span></div>
<div class="line"><a id="l01134" name="l01134"></a><span class="lineno"> 1134</span>                       <span class="stringliteral">&quot;by earlier session-hosed error.  No-op.&quot;</span>);</div>
<div class="line"><a id="l01135" name="l01135"></a><span class="lineno"> 1135</span>      sync_error_but_do_not_emit = <span class="keyword">true</span>;</div>
<div class="line"><a id="l01136" name="l01136"></a><span class="lineno"> 1136</span>      <span class="keywordflow">return</span>;</div>
<div class="line"><a id="l01137" name="l01137"></a><span class="lineno"> 1137</span>    }</div>
<div class="line"><a id="l01138" name="l01138"></a><span class="lineno"> 1138</span>    <span class="comment">// else if (!Base::hosed()): We can attempt sync_request() (which could hose us itself).</span></div>
<div class="line"><a id="l01139" name="l01139"></a><span class="lineno"> 1139</span> </div>
<div class="line"><a id="l01140" name="l01140"></a><span class="lineno"> 1140</span>    <span class="keyword">auto</span>&amp; open_channel_req = *(<span class="keyword">reinterpret_cast&lt;</span><a class="code hl_struct" href="structipc_1_1session_1_1Server__session__impl_1_1Open__channel__req.html">Open_channel_req</a>*<span class="keyword">&gt;</span>(mdt.get()));</div>
<div class="line"><a id="l01141" name="l01141"></a><span class="lineno"> 1141</span> </div>
<div class="line"><a id="l01142" name="l01142"></a><span class="lineno"> 1142</span>    <span class="comment">/* Now simply issue the open-channel request prepared already via `mdt` and synchronously</span></div>
<div class="line"><a id="l01143" name="l01143"></a><span class="lineno"> 1143</span><span class="comment">     * await response, or error, or timeout.  struc::Channel::sync_request() is tailor-made for this. */</span></div>
<div class="line"><a id="l01144" name="l01144"></a><span class="lineno"> 1144</span>    <span class="keyword">const</span> <span class="keyword">auto</span> open_channel_rsp = m_master_channel-&gt;sync_request(open_channel_req.m_req_msg, <span class="keyword">nullptr</span>,</div>
<div class="line"><a id="l01145" name="l01145"></a><span class="lineno"> 1145</span>                                                                 Base::S_OPEN_CHANNEL_TIMEOUT, err_code);</div>
<div class="line"><a id="l01146" name="l01146"></a><span class="lineno"> 1146</span> </div>
<div class="line"><a id="l01147" name="l01147"></a><span class="lineno"> 1147</span>    <span class="keywordflow">if</span> ((!open_channel_rsp) &amp;&amp; (!*err_code))</div>
<div class="line"><a id="l01148" name="l01148"></a><span class="lineno"> 1148</span>    {</div>
<div class="line"><a id="l01149" name="l01149"></a><span class="lineno"> 1149</span>      FLOW_LOG_WARNING(<span class="stringliteral">&quot;Server session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Channel open request failed at the send-request stage &quot;</span></div>
<div class="line"><a id="l01150" name="l01150"></a><span class="lineno"> 1150</span>                       <span class="stringliteral">&quot;(due to incoming-direction error which shall hose session around this time).  No-op.&quot;</span>);</div>
<div class="line"><a id="l01151" name="l01151"></a><span class="lineno"> 1151</span>      sync_error_but_do_not_emit = <span class="keyword">true</span>;</div>
<div class="line"><a id="l01152" name="l01152"></a><span class="lineno"> 1152</span>      <span class="keywordflow">return</span>;</div>
<div class="line"><a id="l01153" name="l01153"></a><span class="lineno"> 1153</span>    }</div>
<div class="line"><a id="l01154" name="l01154"></a><span class="lineno"> 1154</span>    <span class="comment">// else if (*err_code || open_channel_rsp)</span></div>
<div class="line"><a id="l01155" name="l01155"></a><span class="lineno"> 1155</span> </div>
<div class="line"><a id="l01156" name="l01156"></a><span class="lineno"> 1156</span>    <span class="keywordflow">if</span> (*err_code) <span class="comment">// &amp;&amp; !open_channel_rsp)</span></div>
<div class="line"><a id="l01157" name="l01157"></a><span class="lineno"> 1157</span>    {</div>
<div class="line"><a id="l01158" name="l01158"></a><span class="lineno"> 1158</span>      assert((!open_channel_rsp) &amp;&amp; <span class="stringliteral">&quot;struc::Channel::sync_request() must emit no Error_code if it gets response.&quot;</span>);</div>
<div class="line"><a id="l01159" name="l01159"></a><span class="lineno"> 1159</span> </div>
<div class="line"><a id="l01160" name="l01160"></a><span class="lineno"> 1160</span>      <span class="keywordflow">if</span> (*err_code == <a class="code hl_enumvalue" href="namespaceipc_1_1transport_1_1error.html#adfef15ef4e76cc55d652fbd9c2797297abcfca4c2347f9d377dd2ac41c41dc027">transport::error::Code::S_TIMEOUT</a>)</div>
<div class="line"><a id="l01161" name="l01161"></a><span class="lineno"> 1161</span>      {</div>
<div class="line"><a id="l01162" name="l01162"></a><span class="lineno"> 1162</span>        FLOW_LOG_WARNING(<span class="stringliteral">&quot;Server session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Channel open active request: It timed out.  It may &quot;</span></div>
<div class="line"><a id="l01163" name="l01163"></a><span class="lineno"> 1163</span>                         <span class="stringliteral">&quot;complete in the background still, but when it does any result shall be ignored.  &quot;</span></div>
<div class="line"><a id="l01164" name="l01164"></a><span class="lineno"> 1164</span>                         <span class="stringliteral">&quot;Emitting (non-session-hosing) error.&quot;</span>);</div>
<div class="line"><a id="l01165" name="l01165"></a><span class="lineno"> 1165</span> </div>
<div class="line"><a id="l01166" name="l01166"></a><span class="lineno"> 1166</span>        *err_code = <a class="code hl_enumvalue" href="namespaceipc_1_1session_1_1error.html#a0708d4bec9ae853f4d7e3d7822fc8f2fa7d85b87223a9b277b8875c1f7971d6ad">error::Code::S_SESSION_OPEN_CHANNEL_ACTIVE_TIMEOUT</a>;</div>
<div class="line"><a id="l01167" name="l01167"></a><span class="lineno"> 1167</span>        <span class="comment">// Non-session hosing error will be synchronously emitted; *this will continue (as promised).</span></div>
<div class="line"><a id="l01168" name="l01168"></a><span class="lineno"> 1168</span>        <span class="keywordflow">return</span>;</div>
<div class="line"><a id="l01169" name="l01169"></a><span class="lineno"> 1169</span>      }</div>
<div class="line"><a id="l01170" name="l01170"></a><span class="lineno"> 1170</span>      <span class="comment">// else if (*err_code truthy but not timeout): Session got hosed.</span></div>
<div class="line"><a id="l01171" name="l01171"></a><span class="lineno"> 1171</span> </div>
<div class="line"><a id="l01172" name="l01172"></a><span class="lineno"> 1172</span>      <span class="comment">/* As promised, open_channel() hosing the session shall be reported asynchronously like all errors;</span></div>
<div class="line"><a id="l01173" name="l01173"></a><span class="lineno"> 1173</span><span class="comment">       * while we will merely return false. */</span></div>
<div class="line"><a id="l01174" name="l01174"></a><span class="lineno"> 1174</span>      FLOW_LOG_WARNING(<span class="stringliteral">&quot;Server session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Channel open request failed at the sync-request stage, &quot;</span></div>
<div class="line"><a id="l01175" name="l01175"></a><span class="lineno"> 1175</span>                       <span class="stringliteral">&quot;meaning either the nb-send failed, or in-error detected on channel while waiting for &quot;</span></div>
<div class="line"><a id="l01176" name="l01176"></a><span class="lineno"> 1176</span>                       <span class="stringliteral">&quot;response (new error: [&quot;</span> &lt;&lt; *err_code &lt;&lt; <span class="stringliteral">&quot;] [&quot;</span> &lt;&lt; err_code-&gt;message() &lt;&lt; <span class="stringliteral">&quot;]).  Hosing &quot;</span></div>
<div class="line"><a id="l01177" name="l01177"></a><span class="lineno"> 1177</span>                       <span class="stringliteral">&quot;session (emit to session on-error handler); will synchronously return failure to &quot;</span></div>
<div class="line"><a id="l01178" name="l01178"></a><span class="lineno"> 1178</span>                       <span class="stringliteral">&quot;open channel.&quot;</span>);</div>
<div class="line"><a id="l01179" name="l01179"></a><span class="lineno"> 1179</span>      Base::hose(*err_code);</div>
<div class="line"><a id="l01180" name="l01180"></a><span class="lineno"> 1180</span>      sync_error_but_do_not_emit = <span class="keyword">true</span>; <span class="comment">// err_code is ignored.</span></div>
<div class="line"><a id="l01181" name="l01181"></a><span class="lineno"> 1181</span>      <span class="keywordflow">return</span>;</div>
<div class="line"><a id="l01182" name="l01182"></a><span class="lineno"> 1182</span>    }</div>
<div class="line"><a id="l01183" name="l01183"></a><span class="lineno"> 1183</span>    <span class="comment">// else if (!*err_code): sync_request() succeeded all the way.</span></div>
<div class="line"><a id="l01184" name="l01184"></a><span class="lineno"> 1184</span>    assert(open_channel_rsp);</div>
<div class="line"><a id="l01185" name="l01185"></a><span class="lineno"> 1185</span> </div>
<div class="line"><a id="l01186" name="l01186"></a><span class="lineno"> 1186</span>    FLOW_LOG_TRACE(<span class="stringliteral">&quot;Server session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Channel open request: Request message sent to client &quot;</span></div>
<div class="line"><a id="l01187" name="l01187"></a><span class="lineno"> 1187</span>                   <span class="stringliteral">&quot;sans error, and response received in time.&quot;</span>);</div>
<div class="line"><a id="l01188" name="l01188"></a><span class="lineno"> 1188</span> </div>
<div class="line"><a id="l01189" name="l01189"></a><span class="lineno"> 1189</span>    <span class="keyword">const</span> <span class="keyword">auto</span> root = open_channel_rsp-&gt;body_root().getOpenChannelToClientRsp();</div>
<div class="line"><a id="l01190" name="l01190"></a><span class="lineno"> 1190</span>    <span class="keywordflow">switch</span> (root.getOpenChannelResult())</div>
<div class="line"><a id="l01191" name="l01191"></a><span class="lineno"> 1191</span>    {</div>
<div class="line"><a id="l01192" name="l01192"></a><span class="lineno"> 1192</span>    <span class="keywordflow">case</span> OpenChannelResult::ACCEPTED:</div>
<div class="line"><a id="l01193" name="l01193"></a><span class="lineno"> 1193</span>      assert(!*err_code);</div>
<div class="line"><a id="l01194" name="l01194"></a><span class="lineno"> 1194</span>      <span class="keywordflow">break</span>;</div>
<div class="line"><a id="l01195" name="l01195"></a><span class="lineno"> 1195</span>    <span class="keywordflow">case</span> OpenChannelResult::REJECTED_PASSIVE_OPEN:</div>
<div class="line"><a id="l01196" name="l01196"></a><span class="lineno"> 1196</span>      *err_code = <a class="code hl_enumvalue" href="namespaceipc_1_1session_1_1error.html#a0708d4bec9ae853f4d7e3d7822fc8f2fa2c8c27c65ff6234220a84f96de8a1870">error::Code::S_SESSION_OPEN_CHANNEL_REMOTE_PEER_REJECTED_PASSIVE_OPEN</a>;</div>
<div class="line"><a id="l01197" name="l01197"></a><span class="lineno"> 1197</span>      <span class="keywordflow">break</span>;</div>
<div class="line"><a id="l01198" name="l01198"></a><span class="lineno"> 1198</span>    <span class="keywordflow">case</span> OpenChannelResult::REJECTED_RESOURCE_UNAVAILABLE:</div>
<div class="line"><a id="l01199" name="l01199"></a><span class="lineno"> 1199</span>      assert(<span class="keyword">false</span> &amp;&amp; <span class="stringliteral">&quot;Only server grabs channel resources; not possible in server-active-open path.&quot;</span>);</div>
<div class="line"><a id="l01200" name="l01200"></a><span class="lineno"> 1200</span>      <span class="keywordflow">break</span>;</div>
<div class="line"><a id="l01201" name="l01201"></a><span class="lineno"> 1201</span>    <span class="keywordflow">case</span> OpenChannelResult::END_SENTINEL:</div>
<div class="line"><a id="l01202" name="l01202"></a><span class="lineno"> 1202</span>      assert(<span class="keyword">false</span>);</div>
<div class="line"><a id="l01203" name="l01203"></a><span class="lineno"> 1203</span>    } <span class="comment">// Compiler should catch missing enum value.</span></div>
<div class="line"><a id="l01204" name="l01204"></a><span class="lineno"> 1204</span> </div>
<div class="line"><a id="l01205" name="l01205"></a><span class="lineno"> 1205</span>    <span class="keywordflow">if</span> (*err_code)</div>
<div class="line"><a id="l01206" name="l01206"></a><span class="lineno"> 1206</span>    {</div>
<div class="line"><a id="l01207" name="l01207"></a><span class="lineno"> 1207</span>      FLOW_LOG_WARNING(<span class="stringliteral">&quot;Server session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Channel open active request: Response received but &quot;</span></div>
<div class="line"><a id="l01208" name="l01208"></a><span class="lineno"> 1208</span>                       <span class="stringliteral">&quot;indicates remote peer (client) refused; emitting &quot;</span></div>
<div class="line"><a id="l01209" name="l01209"></a><span class="lineno"> 1209</span>                       <span class="stringliteral">&quot;[&quot;</span> &lt;&lt; *err_code &lt;&lt; <span class="stringliteral">&quot;] [&quot;</span> &lt;&lt; err_code-&gt;message() &lt;&lt; <span class="stringliteral">&quot;] with explanation from remote &quot;</span></div>
<div class="line"><a id="l01210" name="l01210"></a><span class="lineno"> 1210</span>                       <span class="stringliteral">&quot;peer.  This will not hose session on our end.&quot;</span>);</div>
<div class="line"><a id="l01211" name="l01211"></a><span class="lineno"> 1211</span>      <span class="comment">// Note: all of the above are advertised as non-session-hosing.</span></div>
<div class="line"><a id="l01212" name="l01212"></a><span class="lineno"> 1212</span>      <span class="keywordflow">return</span>;</div>
<div class="line"><a id="l01213" name="l01213"></a><span class="lineno"> 1213</span>    }</div>
<div class="line"><a id="l01214" name="l01214"></a><span class="lineno"> 1214</span>    <span class="comment">// else: Cool! We already have our side of the channel too.</span></div>
<div class="line"><a id="l01215" name="l01215"></a><span class="lineno"> 1215</span>    assert(open_channel_req.m_opened_channel.initialized());</div>
<div class="line"><a id="l01216" name="l01216"></a><span class="lineno"> 1216</span> </div>
<div class="line"><a id="l01217" name="l01217"></a><span class="lineno"> 1217</span>    *target_channel = std::move(open_channel_req.m_opened_channel);</div>
<div class="line"><a id="l01218" name="l01218"></a><span class="lineno"> 1218</span> </div>
<div class="line"><a id="l01219" name="l01219"></a><span class="lineno"> 1219</span>    FLOW_LOG_INFO(<span class="stringliteral">&quot;Server session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Channel open active request: Succeeded in time yielding &quot;</span></div>
<div class="line"><a id="l01220" name="l01220"></a><span class="lineno"> 1220</span>                  <span class="stringliteral">&quot;new channel [&quot;</span> &lt;&lt; *target_channel &lt;&lt; <span class="stringliteral">&quot;].&quot;</span>);</div>
<div class="line"><a id="l01221" name="l01221"></a><span class="lineno"> 1221</span>  }, Synchronicity::S_ASYNC_AND_AWAIT_CONCURRENT_COMPLETION); <span class="comment">// m_async_worker.post()</span></div>
<div class="line"><a id="l01222" name="l01222"></a><span class="lineno"> 1222</span> </div>
<div class="line"><a id="l01223" name="l01223"></a><span class="lineno"> 1223</span>  <span class="comment">// It all logged sufficiently.  Just return the results.</span></div>
<div class="line"><a id="l01224" name="l01224"></a><span class="lineno"> 1224</span> </div>
<div class="line"><a id="l01225" name="l01225"></a><span class="lineno"> 1225</span>  <span class="keywordflow">if</span> (sync_error_but_do_not_emit)</div>
<div class="line"><a id="l01226" name="l01226"></a><span class="lineno"> 1226</span>  {</div>
<div class="line"><a id="l01227" name="l01227"></a><span class="lineno"> 1227</span>    err_code-&gt;clear();</div>
<div class="line"><a id="l01228" name="l01228"></a><span class="lineno"> 1228</span>    <span class="keywordflow">return</span> <span class="keyword">false</span>;</div>
<div class="line"><a id="l01229" name="l01229"></a><span class="lineno"> 1229</span>  }</div>
<div class="line"><a id="l01230" name="l01230"></a><span class="lineno"> 1230</span>  <span class="comment">// else</span></div>
<div class="line"><a id="l01231" name="l01231"></a><span class="lineno"> 1231</span> </div>
<div class="line"><a id="l01232" name="l01232"></a><span class="lineno"> 1232</span>  <span class="keywordflow">return</span> <span class="keyword">true</span>; <span class="comment">// *err_code may be truthy or falsy.</span></div>
<div class="line"><a id="l01233" name="l01233"></a><span class="lineno"> 1233</span>} <span class="comment">// Server_session_impl::open_channel()</span></div>
<div class="line"><a id="l01234" name="l01234"></a><span class="lineno"> 1234</span> </div>
<div class="line"><a id="l01235" name="l01235"></a><span class="lineno"> 1235</span><a class="code hl_define" href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp.html#aea842eaa966995a5ff8abf5672a25a5f">TEMPLATE_SRV_SESSION_IMPL</a></div>
<div class="line"><a id="l01236" name="l01236"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#adfb10992398b46be3b0e1ac0c8605ef4"> 1236</a></span><span class="keywordtype">bool</span> CLASS_SRV_SESSION_IMPL::open_channel(<a class="code hl_typedef" href="classipc_1_1session_1_1Server__session__impl.html#a7c969c3a1007f8e4ba3ad1c1acd6c290">Channel_obj</a>* target_channel, <a class="code hl_typedef" href="namespaceipc.html#aa3192e586cc45d3e7c22463bf2760f89">Error_code</a>* err_code)</div>
<div class="line"><a id="l01237" name="l01237"></a><span class="lineno"> 1237</span>{</div>
<div class="line"><a id="l01238" name="l01238"></a><span class="lineno"> 1238</span>  <span class="comment">// We are in thread U.</span></div>
<div class="line"><a id="l01239" name="l01239"></a><span class="lineno"> 1239</span>  <span class="keywordflow">return</span> open_channel(target_channel, mdt_builder(), err_code);</div>
<div class="line"><a id="l01240" name="l01240"></a><span class="lineno"> 1240</span>}</div>
<div class="line"><a id="l01241" name="l01241"></a><span class="lineno"> 1241</span> </div>
<div class="line"><a id="l01242" name="l01242"></a><span class="lineno"> 1242</span><a class="code hl_define" href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp.html#aea842eaa966995a5ff8abf5672a25a5f">TEMPLATE_SRV_SESSION_IMPL</a></div>
<div class="line"><a id="l01243" name="l01243"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#a804c629b2da8898376f071db499a2173"> 1243</a></span><span class="keywordtype">void</span> CLASS_SRV_SESSION_IMPL::on_master_channel_open_channel_req</div>
<div class="line"><a id="l01244" name="l01244"></a><span class="lineno"> 1244</span>       (<span class="keyword">typename</span> Master_structured_channel::Msg_in_ptr&amp;&amp; open_channel_req)</div>
<div class="line"><a id="l01245" name="l01245"></a><span class="lineno"> 1245</span>{</div>
<div class="line"><a id="l01246" name="l01246"></a><span class="lineno"> 1246</span>  <span class="keyword">using </span>schema::detail::OpenChannelResult;</div>
<div class="line"><a id="l01247" name="l01247"></a><span class="lineno"> 1247</span>  <span class="keyword">using </span>transport::struc::schema::Metadata;</div>
<div class="line"><a id="l01248" name="l01248"></a><span class="lineno"> 1248</span>  <span class="keyword">using </span><a class="code hl_struct" href="structipc_1_1util_1_1Native__handle.html">util::Native_handle</a>;</div>
<div class="line"><a id="l01249" name="l01249"></a><span class="lineno"> 1249</span>  <span class="keyword">using </span>boost::shared_ptr;</div>
<div class="line"><a id="l01250" name="l01250"></a><span class="lineno"> 1250</span> </div>
<div class="line"><a id="l01251" name="l01251"></a><span class="lineno"> 1251</span>  <span class="comment">// We are in thread W.</span></div>
<div class="line"><a id="l01252" name="l01252"></a><span class="lineno"> 1252</span> </div>
<div class="line"><a id="l01253" name="l01253"></a><span class="lineno"> 1253</span>  <span class="keywordflow">if</span> (Base::hosed())</div>
<div class="line"><a id="l01254" name="l01254"></a><span class="lineno"> 1254</span>  {</div>
<div class="line"><a id="l01255" name="l01255"></a><span class="lineno"> 1255</span>    <span class="comment">/* Another thread-W task hosed the session.  It shouldn&#39;t be due to m_master_channel itself firing error,</span></div>
<div class="line"><a id="l01256" name="l01256"></a><span class="lineno"> 1256</span><span class="comment">     * as then we shouldn&#39;t be called, but maybe our own logic found some session-hosing condition in the meantime. */</span></div>
<div class="line"><a id="l01257" name="l01257"></a><span class="lineno"> 1257</span>    <span class="keywordflow">return</span>;</div>
<div class="line"><a id="l01258" name="l01258"></a><span class="lineno"> 1258</span>  }</div>
<div class="line"><a id="l01259" name="l01259"></a><span class="lineno"> 1259</span>  <span class="comment">// else if (!Base::hosed()): Our time to shine.  We may may make Base::hosed() true ourselves, in peace, below.</span></div>
<div class="line"><a id="l01260" name="l01260"></a><span class="lineno"> 1260</span> </div>
<div class="line"><a id="l01261" name="l01261"></a><span class="lineno"> 1261</span>  OpenChannelResult open_channel_result = OpenChannelResult::ACCEPTED;</div>
<div class="line"><a id="l01262" name="l01262"></a><span class="lineno"> 1262</span>  <a class="code hl_typedef" href="classipc_1_1session_1_1Server__session__impl.html#a7c969c3a1007f8e4ba3ad1c1acd6c290">Channel_obj</a> opened_channel;</div>
<div class="line"><a id="l01263" name="l01263"></a><span class="lineno"> 1263</span>  <a class="code hl_typedef" href="namespaceipc_1_1transport.html#a7ee4551983d9df16ec16a3139bac50e8">Native_handle</a> remote_hndl_or_null;</div>
<div class="line"><a id="l01264" name="l01264"></a><span class="lineno"> 1264</span>  <a class="code hl_class" href="classipc_1_1util_1_1Shared__name.html">Shared_name</a> mq_name_c2s_or_none;</div>
<div class="line"><a id="l01265" name="l01265"></a><span class="lineno"> 1265</span>  <a class="code hl_class" href="classipc_1_1util_1_1Shared__name.html">Shared_name</a> mq_name_s2c_or_none;</div>
<div class="line"><a id="l01266" name="l01266"></a><span class="lineno"> 1266</span> </div>
<div class="line"><a id="l01267" name="l01267"></a><span class="lineno"> 1267</span>  <span class="keyword">const</span> <span class="keyword">auto</span>&amp; on_passive_open_func = Base::on_passive_open_channel_func_or_empty();</div>
<div class="line"><a id="l01268" name="l01268"></a><span class="lineno"> 1268</span>  <span class="keywordflow">if</span> (on_passive_open_func.empty())</div>
<div class="line"><a id="l01269" name="l01269"></a><span class="lineno"> 1269</span>  {</div>
<div class="line"><a id="l01270" name="l01270"></a><span class="lineno"> 1270</span>    open_channel_result = OpenChannelResult::REJECTED_PASSIVE_OPEN;</div>
<div class="line"><a id="l01271" name="l01271"></a><span class="lineno"> 1271</span>  }</div>
<div class="line"><a id="l01272" name="l01272"></a><span class="lineno"> 1272</span>  <span class="keywordflow">else</span> <span class="comment">// if (passive opens enabled)</span></div>
<div class="line"><a id="l01273" name="l01273"></a><span class="lineno"> 1273</span>  {</div>
<div class="line"><a id="l01274" name="l01274"></a><span class="lineno"> 1274</span>    <span class="keywordflow">if</span> (!create_channel_and_resources(&amp;mq_name_c2s_or_none, &amp;mq_name_s2c_or_none, &amp;remote_hndl_or_null,</div>
<div class="line"><a id="l01275" name="l01275"></a><span class="lineno"> 1275</span>                                      &amp;opened_channel, <span class="keyword">false</span>)) <span class="comment">// false =&gt; passive-open, not active-open.</span></div>
<div class="line"><a id="l01276" name="l01276"></a><span class="lineno"> 1276</span>    {</div>
<div class="line"><a id="l01277" name="l01277"></a><span class="lineno"> 1277</span>      open_channel_result = OpenChannelResult::REJECTED_RESOURCE_UNAVAILABLE;</div>
<div class="line"><a id="l01278" name="l01278"></a><span class="lineno"> 1278</span>    }</div>
<div class="line"><a id="l01279" name="l01279"></a><span class="lineno"> 1279</span>    <span class="comment">// else if (create_channel_and_resources() worked) { Fall through. }</span></div>
<div class="line"><a id="l01280" name="l01280"></a><span class="lineno"> 1280</span>  } <span class="comment">// else if (passive opens enabled)</span></div>
<div class="line"><a id="l01281" name="l01281"></a><span class="lineno"> 1281</span> </div>
<div class="line"><a id="l01282" name="l01282"></a><span class="lineno"> 1282</span>  <a class="code hl_typedef" href="classipc_1_1session_1_1Server__session__impl.html#a78e61f8681c7ec92fa19bae560763ab1">Mdt_reader_ptr</a> mdt; <span class="comment">// Null for now; set inside below in the success case.</span></div>
<div class="line"><a id="l01283" name="l01283"></a><span class="lineno"> 1283</span> </div>
<div class="line"><a id="l01284" name="l01284"></a><span class="lineno"> 1284</span>  <span class="keyword">auto</span> open_channel_rsp = m_master_channel-&gt;create_msg();</div>
<div class="line"><a id="l01285" name="l01285"></a><span class="lineno"> 1285</span>  <span class="keyword">const</span> <span class="keyword">auto</span> open_channel_req_saved = open_channel_req.get(); <span class="comment">// It&#39;ll get move()d away below possibly; just save it.</span></div>
<div class="line"><a id="l01286" name="l01286"></a><span class="lineno"> 1286</span>  open_channel_rsp.body_root()-&gt;initOpenChannelToServerRsp().setOpenChannelResult(open_channel_result);</div>
<div class="line"><a id="l01287" name="l01287"></a><span class="lineno"> 1287</span> </div>
<div class="line"><a id="l01288" name="l01288"></a><span class="lineno"> 1288</span>  <span class="keywordflow">if</span> (open_channel_result == OpenChannelResult::ACCEPTED)</div>
<div class="line"><a id="l01289" name="l01289"></a><span class="lineno"> 1289</span>  {</div>
<div class="line"><a id="l01290" name="l01290"></a><span class="lineno"> 1290</span>    <span class="comment">// These names may both be empty (&lt;=&gt; the compile-time config implies no MQs are needed).</span></div>
<div class="line"><a id="l01291" name="l01291"></a><span class="lineno"> 1291</span>    assert(((!remote_hndl_or_null.null()) || ((!mq_name_c2s_or_none.<a class="code hl_function" href="classipc_1_1util_1_1Shared__name.html#a861ea6c9ad6672e83bab5c7747b66f7b">empty</a>()) &amp;&amp; (!mq_name_s2c_or_none.<a class="code hl_function" href="classipc_1_1util_1_1Shared__name.html#a861ea6c9ad6672e83bab5c7747b66f7b">empty</a>())))</div>
<div class="line"><a id="l01292" name="l01292"></a><span class="lineno"> 1292</span>           &amp;&amp; <span class="stringliteral">&quot;The channel had to have been configured to have at least one of: MQs, socket stream.&quot;</span>);</div>
<div class="line"><a id="l01293" name="l01293"></a><span class="lineno"> 1293</span> </div>
<div class="line"><a id="l01294" name="l01294"></a><span class="lineno"> 1294</span>    <span class="comment">// remote_hndl_or_null may or may not be null (&lt;=&gt; the compile-time config implies no socket stream is needed).</span></div>
<div class="line"><a id="l01295" name="l01295"></a><span class="lineno"> 1295</span>    open_channel_rsp.store_native_handle_or_null(std::move(remote_hndl_or_null));</div>
<div class="line"><a id="l01296" name="l01296"></a><span class="lineno"> 1296</span>    assert(remote_hndl_or_null.null() &amp;&amp; <span class="stringliteral">&quot;store_native_handle_or_null() should have eaten any Native_handle.&quot;</span>);</div>
<div class="line"><a id="l01297" name="l01297"></a><span class="lineno"> 1297</span> </div>
<div class="line"><a id="l01298" name="l01298"></a><span class="lineno"> 1298</span>    <span class="keyword">auto</span> open_channel_rsp_root = open_channel_rsp.body_root()-&gt;initOpenChannelToServerRsp();</div>
<div class="line"><a id="l01299" name="l01299"></a><span class="lineno"> 1299</span>    open_channel_rsp_root.setClientToServerMqAbsNameOrEmpty(mq_name_c2s_or_none.<a class="code hl_function" href="classipc_1_1util_1_1Shared__name.html#ae89e1e061f87ffe0288514e254837595">str</a>());</div>
<div class="line"><a id="l01300" name="l01300"></a><span class="lineno"> 1300</span>    open_channel_rsp_root.setServerToClientMqAbsNameOrEmpty(mq_name_s2c_or_none.<a class="code hl_function" href="classipc_1_1util_1_1Shared__name.html#ae89e1e061f87ffe0288514e254837595">str</a>());</div>
<div class="line"><a id="l01301" name="l01301"></a><span class="lineno"> 1301</span> </div>
<div class="line"><a id="l01302" name="l01302"></a><span class="lineno"> 1302</span>    <span class="comment">/* open_channel_rsp is ready to go.  That&#39;s for us to send.</span></div>
<div class="line"><a id="l01303" name="l01303"></a><span class="lineno"> 1303</span><span class="comment">     * Locally we need to emit opened_channel; that&#39;s ready too.</span></div>
<div class="line"><a id="l01304" name="l01304"></a><span class="lineno"> 1304</span><span class="comment">     * Locally, lastly, we need to emit the channel-open metadata from the open-channel request.  Take care of that</span></div>
<div class="line"><a id="l01305" name="l01305"></a><span class="lineno"> 1305</span><span class="comment">     * now.  See similar code in Client_session_impl; there&#39;s a comment explaining this in a bit more detail. */</span></div>
<div class="line"><a id="l01306" name="l01306"></a><span class="lineno"> 1306</span>    <span class="keyword">struct </span>Req_and_mdt_reader</div>
<div class="line"><a id="l01307" name="l01307"></a><span class="lineno"> 1307</span>    {</div>
<div class="line"><a id="l01308" name="l01308"></a><span class="lineno"> 1308</span>      <span class="keyword">typename</span> Mdt_reader_ptr::element_type m_mdt_reader;</div>
<div class="line"><a id="l01309" name="l01309"></a><span class="lineno"> 1309</span>      <span class="keyword">typename</span> Master_structured_channel::Msg_in_ptr m_req;</div>
<div class="line"><a id="l01310" name="l01310"></a><span class="lineno"> 1310</span>    };</div>
<div class="line"><a id="l01311" name="l01311"></a><span class="lineno"> 1311</span>    shared_ptr&lt;Req_and_mdt_reader&gt; req_and_mdt(<span class="keyword">new</span> Req_and_mdt_reader</div>
<div class="line"><a id="l01312" name="l01312"></a><span class="lineno"> 1312</span>                                                     { open_channel_req-&gt;body_root()</div>
<div class="line"><a id="l01313" name="l01313"></a><span class="lineno"> 1313</span>                                                         .getOpenChannelToServerReq().getMetadata(),</div>
<div class="line"><a id="l01314" name="l01314"></a><span class="lineno"> 1314</span>                                                       std::move(open_channel_req) });</div>
<div class="line"><a id="l01315" name="l01315"></a><span class="lineno"> 1315</span>    mdt = <a class="code hl_typedef" href="classipc_1_1session_1_1Server__session__impl.html#a78e61f8681c7ec92fa19bae560763ab1">Mdt_reader_ptr</a>(std::move(req_and_mdt), &amp;req_and_mdt-&gt;m_mdt_reader);</div>
<div class="line"><a id="l01316" name="l01316"></a><span class="lineno"> 1316</span>  } <span class="comment">// else if (open_channel_result == ACCEPTED)</span></div>
<div class="line"><a id="l01317" name="l01317"></a><span class="lineno"> 1317</span> </div>
<div class="line"><a id="l01318" name="l01318"></a><span class="lineno"> 1318</span>  <a class="code hl_typedef" href="namespaceipc.html#aa3192e586cc45d3e7c22463bf2760f89">Error_code</a> err_code;</div>
<div class="line"><a id="l01319" name="l01319"></a><span class="lineno"> 1319</span>  <span class="keywordflow">if</span> (!m_master_channel-&gt;send(open_channel_rsp, open_channel_req_saved, &amp;err_code))</div>
<div class="line"><a id="l01320" name="l01320"></a><span class="lineno"> 1320</span>  {</div>
<div class="line"><a id="l01321" name="l01321"></a><span class="lineno"> 1321</span>    <span class="keywordflow">return</span>;</div>
<div class="line"><a id="l01322" name="l01322"></a><span class="lineno"> 1322</span>  }</div>
<div class="line"><a id="l01323" name="l01323"></a><span class="lineno"> 1323</span>  <span class="comment">// else</span></div>
<div class="line"><a id="l01324" name="l01324"></a><span class="lineno"> 1324</span>  <span class="keywordflow">if</span> (err_code)</div>
<div class="line"><a id="l01325" name="l01325"></a><span class="lineno"> 1325</span>  {</div>
<div class="line"><a id="l01326" name="l01326"></a><span class="lineno"> 1326</span>    FLOW_LOG_WARNING(<span class="stringliteral">&quot;Server session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Passive open-channel: send() of OpenChannelToServerRsp &quot;</span></div>
<div class="line"><a id="l01327" name="l01327"></a><span class="lineno"> 1327</span>                     <span class="stringliteral">&quot;failed (details above presumably); this hoses the session.  Emitting to user handler.&quot;</span>);</div>
<div class="line"><a id="l01328" name="l01328"></a><span class="lineno"> 1328</span>    Base::hose(err_code);</div>
<div class="line"><a id="l01329" name="l01329"></a><span class="lineno"> 1329</span>    <span class="keywordflow">return</span>;</div>
<div class="line"><a id="l01330" name="l01330"></a><span class="lineno"> 1330</span>  } <span class="comment">// if (err_code on send())</span></div>
<div class="line"><a id="l01331" name="l01331"></a><span class="lineno"> 1331</span>  <span class="comment">// else</span></div>
<div class="line"><a id="l01332" name="l01332"></a><span class="lineno"> 1332</span> </div>
<div class="line"><a id="l01333" name="l01333"></a><span class="lineno"> 1333</span>  <span class="keywordflow">if</span> (open_channel_result != OpenChannelResult::ACCEPTED)</div>
<div class="line"><a id="l01334" name="l01334"></a><span class="lineno"> 1334</span>  {</div>
<div class="line"><a id="l01335" name="l01335"></a><span class="lineno"> 1335</span>    <span class="comment">// Cool.  Well, from our point of view it&#39;s cool; the user has some stuff to figure out on their app protocol level.</span></div>
<div class="line"><a id="l01336" name="l01336"></a><span class="lineno"> 1336</span>    FLOW_LOG_WARNING(<span class="stringliteral">&quot;Server session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Passive open-channel: We have rejected passive-open request &quot;</span></div>
<div class="line"><a id="l01337" name="l01337"></a><span class="lineno"> 1337</span>                     <span class="stringliteral">&quot;(reason explained above hopefully).  Response indicating this is sent.  Done.&quot;</span>);</div>
<div class="line"><a id="l01338" name="l01338"></a><span class="lineno"> 1338</span>    <span class="keywordflow">return</span>;</div>
<div class="line"><a id="l01339" name="l01339"></a><span class="lineno"> 1339</span>  }</div>
<div class="line"><a id="l01340" name="l01340"></a><span class="lineno"> 1340</span>  <span class="comment">// else</span></div>
<div class="line"><a id="l01341" name="l01341"></a><span class="lineno"> 1341</span> </div>
<div class="line"><a id="l01342" name="l01342"></a><span class="lineno"> 1342</span>  <span class="comment">// Great!</span></div>
<div class="line"><a id="l01343" name="l01343"></a><span class="lineno"> 1343</span>  FLOW_LOG_INFO(<span class="stringliteral">&quot;Server session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Passive open-channel: Successful on this side!  Response sent; &quot;</span></div>
<div class="line"><a id="l01344" name="l01344"></a><span class="lineno"> 1344</span>                <span class="stringliteral">&quot;remote peer (client) shall establish its peer object once received.  We emit local peer Channel &quot;</span></div>
<div class="line"><a id="l01345" name="l01345"></a><span class="lineno"> 1345</span>                <span class="stringliteral">&quot;object [&quot;</span> &lt;&lt; opened_channel &lt;&lt; <span class="stringliteral">&quot;], plus the channel-open metadata, &quot;</span></div>
<div class="line"><a id="l01346" name="l01346"></a><span class="lineno"> 1346</span>                <span class="stringliteral">&quot;to user via passive-channel-open handler.&quot;</span>);</div>
<div class="line"><a id="l01347" name="l01347"></a><span class="lineno"> 1347</span>  on_passive_open_func(std::move(opened_channel), std::move(mdt));</div>
<div class="line"><a id="l01348" name="l01348"></a><span class="lineno"> 1348</span>  FLOW_LOG_TRACE(<span class="stringliteral">&quot;Handler finished.&quot;</span>);</div>
<div class="line"><a id="l01349" name="l01349"></a><span class="lineno"> 1349</span>} <span class="comment">// Server_session_impl::on_master_channel_open_channel_req()</span></div>
<div class="line"><a id="l01350" name="l01350"></a><span class="lineno"> 1350</span> </div>
<div class="line"><a id="l01351" name="l01351"></a><span class="lineno"> 1351</span><a class="code hl_define" href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp.html#aea842eaa966995a5ff8abf5672a25a5f">TEMPLATE_SRV_SESSION_IMPL</a></div>
<div class="line"><a id="l01352" name="l01352"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#a6f756d12f9e2b2cc3269564ba49bb354"> 1352</a></span><span class="keywordtype">bool</span> CLASS_SRV_SESSION_IMPL::create_channel_and_resources(<a class="code hl_class" href="classipc_1_1util_1_1Shared__name.html">Shared_name</a>* mq_name_c2s_or_none_ptr,</div>
<div class="line"><a id="l01353" name="l01353"></a><span class="lineno"> 1353</span>                                                          <a class="code hl_class" href="classipc_1_1util_1_1Shared__name.html">Shared_name</a>* mq_name_s2c_or_none_ptr,</div>
<div class="line"><a id="l01354" name="l01354"></a><span class="lineno"> 1354</span>                                                          <a class="code hl_struct" href="structipc_1_1util_1_1Native__handle.html">util::Native_handle</a>* remote_hndl_or_null_ptr,</div>
<div class="line"><a id="l01355" name="l01355"></a><span class="lineno"> 1355</span>                                                          <a class="code hl_typedef" href="classipc_1_1session_1_1Server__session__impl.html#a7c969c3a1007f8e4ba3ad1c1acd6c290">Channel_obj</a>* opened_channel_ptr,</div>
<div class="line"><a id="l01356" name="l01356"></a><span class="lineno"> 1356</span>                                                          <span class="keywordtype">bool</span> active_else_passive)</div>
<div class="line"><a id="l01357" name="l01357"></a><span class="lineno"> 1357</span>{</div>
<div class="line"><a id="l01358" name="l01358"></a><span class="lineno"> 1358</span>  <span class="keyword">using </span><a class="code hl_struct" href="structipc_1_1util_1_1Native__handle.html">util::Native_handle</a>;</div>
<div class="line"><a id="l01359" name="l01359"></a><span class="lineno"> 1359</span>  <span class="keyword">using </span><a class="code hl_class" href="classipc_1_1transport_1_1sync__io_1_1Native__socket__stream.html">transport::sync_io::Native_socket_stream</a>;</div>
<div class="line"><a id="l01360" name="l01360"></a><span class="lineno"> 1360</span>  <span class="keyword">using </span><a class="code hl_class" href="classipc_1_1transport_1_1Socket__stream__channel.html">transport::Socket_stream_channel</a>;</div>
<div class="line"><a id="l01361" name="l01361"></a><span class="lineno"> 1361</span>  <span class="keyword">using </span><a class="code hl_class" href="classipc_1_1transport_1_1Mqs__channel.html">transport::Mqs_channel</a>;</div>
<div class="line"><a id="l01362" name="l01362"></a><span class="lineno"> 1362</span>  <span class="keyword">using </span><a class="code hl_class" href="classipc_1_1transport_1_1Mqs__socket__stream__channel.html">transport::Mqs_socket_stream_channel</a>;</div>
<div class="line"><a id="l01363" name="l01363"></a><span class="lineno"> 1363</span>  <span class="keyword">using </span><a class="code hl_class" href="classipc_1_1transport_1_1Socket__stream__channel__of__blobs.html">transport::Socket_stream_channel_of_blobs</a>;</div>
<div class="line"><a id="l01364" name="l01364"></a><span class="lineno"> 1364</span>  <span class="keyword">namespace </span>asio_local = transport::asio_local_stream_socket::local_ns;</div>
<div class="line"><a id="l01365" name="l01365"></a><span class="lineno"> 1365</span>  <span class="keyword">using </span>asio_local::connect_pair;</div>
<div class="line"><a id="l01366" name="l01366"></a><span class="lineno"> 1366</span>  <span class="keyword">using </span><a class="code hl_typedef" href="namespaceipc_1_1transport_1_1asio__local__stream__socket.html#a1788f9dbd896bb71b3693f9ae25b40ae">transport::asio_local_stream_socket::Peer_socket</a>;</div>
<div class="line"><a id="l01367" name="l01367"></a><span class="lineno"> 1367</span>  <span class="keyword">using </span>flow::util::ostream_op_string;</div>
<div class="line"><a id="l01368" name="l01368"></a><span class="lineno"> 1368</span> </div>
<div class="line"><a id="l01369" name="l01369"></a><span class="lineno"> 1369</span>  <span class="comment">// We are in thread W.</span></div>
<div class="line"><a id="l01370" name="l01370"></a><span class="lineno"> 1370</span>  <span class="keyword">auto</span>&amp; opened_channel = *opened_channel_ptr;</div>
<div class="line"><a id="l01371" name="l01371"></a><span class="lineno"> 1371</span>  <span class="keyword">auto</span>&amp; remote_hndl_or_null = *remote_hndl_or_null_ptr;</div>
<div class="line"><a id="l01372" name="l01372"></a><span class="lineno"> 1372</span>  <span class="keyword">auto</span>&amp; mq_name_c2s_or_none = *mq_name_c2s_or_none_ptr;</div>
<div class="line"><a id="l01373" name="l01373"></a><span class="lineno"> 1373</span>  <span class="keyword">auto</span>&amp; mq_name_s2c_or_none = *mq_name_s2c_or_none_ptr;</div>
<div class="line"><a id="l01374" name="l01374"></a><span class="lineno"> 1374</span> </div>
<div class="line"><a id="l01375" name="l01375"></a><span class="lineno"> 1375</span>  assert(!opened_channel.initialized());</div>
<div class="line"><a id="l01376" name="l01376"></a><span class="lineno"> 1376</span>  assert(remote_hndl_or_null.null());</div>
<div class="line"><a id="l01377" name="l01377"></a><span class="lineno"> 1377</span>  assert(mq_name_c2s_or_none.empty());</div>
<div class="line"><a id="l01378" name="l01378"></a><span class="lineno"> 1378</span>  assert(mq_name_s2c_or_none.empty());</div>
<div class="line"><a id="l01379" name="l01379"></a><span class="lineno"> 1379</span> </div>
<div class="line"><a id="l01380" name="l01380"></a><span class="lineno"> 1380</span>  Native_socket_stream local_sock_stm_or_null;</div>
<div class="line"><a id="l01381" name="l01381"></a><span class="lineno"> 1381</span>  <a class="code hl_typedef" href="namespaceipc.html#aa3192e586cc45d3e7c22463bf2760f89">Error_code</a> sys_err_code;</div>
<div class="line"><a id="l01382" name="l01382"></a><span class="lineno"> 1382</span>  <span class="keyword">const</span> <span class="keyword">auto</span> nickname = active_else_passive ? ostream_op_string(<span class="stringliteral">&quot;active&quot;</span>, ++m_last_actively_opened_channel_id)</div>
<div class="line"><a id="l01383" name="l01383"></a><span class="lineno"> 1383</span>                                            : ostream_op_string(<span class="stringliteral">&quot;passive&quot;</span>, ++m_last_passively_opened_channel_id);</div>
<div class="line"><a id="l01384" name="l01384"></a><span class="lineno"> 1384</span> </div>
<div class="line"><a id="l01385" name="l01385"></a><span class="lineno"> 1385</span>  [[maybe_unused]] <span class="keyword">const</span> <span class="keyword">auto</span> make_sock_stm_func = [&amp;]()</div>
<div class="line"><a id="l01386" name="l01386"></a><span class="lineno"> 1386</span>  {</div>
<div class="line"><a id="l01387" name="l01387"></a><span class="lineno"> 1387</span>    <a class="code hl_typedef" href="namespaceipc_1_1transport.html#a7ee4551983d9df16ec16a3139bac50e8">Native_handle</a> local_hndl;</div>
<div class="line"><a id="l01388" name="l01388"></a><span class="lineno"> 1388</span> </div>
<div class="line"><a id="l01389" name="l01389"></a><span class="lineno"> 1389</span>    <a class="code hl_typedef" href="namespaceipc_1_1transport_1_1asio__local__stream__socket.html#a1788f9dbd896bb71b3693f9ae25b40ae">Peer_socket</a> local_hndl_asio(*m_async_worker.task_engine());</div>
<div class="line"><a id="l01390" name="l01390"></a><span class="lineno"> 1390</span>    <a class="code hl_typedef" href="namespaceipc_1_1transport_1_1asio__local__stream__socket.html#a1788f9dbd896bb71b3693f9ae25b40ae">Peer_socket</a> remote_hndl_asio(std::move(local_hndl_asio));</div>
<div class="line"><a id="l01391" name="l01391"></a><span class="lineno"> 1391</span>    connect_pair(local_hndl_asio, remote_hndl_asio, sys_err_code);</div>
<div class="line"><a id="l01392" name="l01392"></a><span class="lineno"> 1392</span>    <span class="keywordflow">if</span> (sys_err_code)</div>
<div class="line"><a id="l01393" name="l01393"></a><span class="lineno"> 1393</span>    {</div>
<div class="line"><a id="l01394" name="l01394"></a><span class="lineno"> 1394</span>      FLOW_LOG_WARNING(<span class="stringliteral">&quot;Server session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Open-channel (active? = [&quot;</span> &lt;&lt; active_else_passive &lt;&lt; <span class="stringliteral">&quot;]): &quot;</span></div>
<div class="line"><a id="l01395" name="l01395"></a><span class="lineno"> 1395</span>                       <span class="stringliteral">&quot;connect_pair() failed.  Not fatal to the session; will inform the remote peer (client) &quot;</span></div>
<div class="line"><a id="l01396" name="l01396"></a><span class="lineno"> 1396</span>                       <span class="stringliteral">&quot;(if passive-open) or caller (if active-open).  Details follow.&quot;</span>);</div>
<div class="line"><a id="l01397" name="l01397"></a><span class="lineno"> 1397</span>      FLOW_ERROR_SYS_ERROR_LOG_WARNING(); <span class="comment">// Log based on sys_err_code.</span></div>
<div class="line"><a id="l01398" name="l01398"></a><span class="lineno"> 1398</span>      <span class="keywordflow">return</span> <span class="keyword">false</span>;</div>
<div class="line"><a id="l01399" name="l01399"></a><span class="lineno"> 1399</span>    }</div>
<div class="line"><a id="l01400" name="l01400"></a><span class="lineno"> 1400</span>    <span class="comment">// else</span></div>
<div class="line"><a id="l01401" name="l01401"></a><span class="lineno"> 1401</span>    local_hndl = <a class="code hl_typedef" href="namespaceipc_1_1transport.html#a7ee4551983d9df16ec16a3139bac50e8">Native_handle</a>(local_hndl_asio.release());</div>
<div class="line"><a id="l01402" name="l01402"></a><span class="lineno"> 1402</span>    remote_hndl_or_null = <a class="code hl_typedef" href="namespaceipc_1_1transport.html#a7ee4551983d9df16ec16a3139bac50e8">Native_handle</a>(remote_hndl_asio.release());</div>
<div class="line"><a id="l01403" name="l01403"></a><span class="lineno"> 1403</span> </div>
<div class="line"><a id="l01404" name="l01404"></a><span class="lineno"> 1404</span>    FLOW_LOG_TRACE(<span class="stringliteral">&quot;Server session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Open-channel (active? = [&quot;</span> &lt;&lt; active_else_passive &lt;&lt; <span class="stringliteral">&quot;]): &quot;</span></div>
<div class="line"><a id="l01405" name="l01405"></a><span class="lineno"> 1405</span>                   <span class="stringliteral">&quot;connect_pair() generated native handles [&quot;</span> &lt;&lt; local_hndl &lt;&lt; <span class="stringliteral">&quot;], [&quot;</span> &lt;&lt; remote_hndl_or_null &lt;&lt; <span class="stringliteral">&quot;], &quot;</span></div>
<div class="line"><a id="l01406" name="l01406"></a><span class="lineno"> 1406</span>                   <span class="stringliteral">&quot;the latter to be transmitted to remote peer (client).&quot;</span>);</div>
<div class="line"><a id="l01407" name="l01407"></a><span class="lineno"> 1407</span>    local_sock_stm_or_null = Native_socket_stream(get_logger(), nickname, std::move(local_hndl));</div>
<div class="line"><a id="l01408" name="l01408"></a><span class="lineno"> 1408</span>    <span class="keywordflow">return</span> <span class="keyword">true</span>;</div>
<div class="line"><a id="l01409" name="l01409"></a><span class="lineno"> 1409</span>  }; <span class="comment">// make_sock_stm_func =</span></div>
<div class="line"><a id="l01410" name="l01410"></a><span class="lineno"> 1410</span> </div>
<div class="line"><a id="l01411" name="l01411"></a><span class="lineno"> 1411</span>  <span class="keywordflow">if</span> <span class="keyword">constexpr</span>(S_MQS_ENABLED)</div>
<div class="line"><a id="l01412" name="l01412"></a><span class="lineno"> 1412</span>  {</div>
<div class="line"><a id="l01413" name="l01413"></a><span class="lineno"> 1413</span>    <a class="code hl_typedef" href="classipc_1_1session_1_1Server__session__impl.html#aa72ad11c33a4d11d5e3f0480ce0a6ff1">Persistent_mq_handle_from_cfg</a> mq_c2s;</div>
<div class="line"><a id="l01414" name="l01414"></a><span class="lineno"> 1414</span>    <a class="code hl_typedef" href="classipc_1_1session_1_1Server__session__impl.html#aa72ad11c33a4d11d5e3f0480ce0a6ff1">Persistent_mq_handle_from_cfg</a> mq_s2c;</div>
<div class="line"><a id="l01415" name="l01415"></a><span class="lineno"> 1415</span> </div>
<div class="line"><a id="l01416" name="l01416"></a><span class="lineno"> 1416</span>    <span class="keywordflow">if</span> (!make_channel_mqs(&amp;mq_c2s, &amp;mq_s2c, &amp;mq_name_c2s_or_none, &amp;mq_name_s2c_or_none, &amp;sys_err_code))</div>
<div class="line"><a id="l01417" name="l01417"></a><span class="lineno"> 1417</span>    {</div>
<div class="line"><a id="l01418" name="l01418"></a><span class="lineno"> 1418</span>      <span class="keywordflow">return</span> <span class="keyword">false</span>;</div>
<div class="line"><a id="l01419" name="l01419"></a><span class="lineno"> 1419</span>    }</div>
<div class="line"><a id="l01420" name="l01420"></a><span class="lineno"> 1420</span>    <span class="comment">// else</span></div>
<div class="line"><a id="l01421" name="l01421"></a><span class="lineno"> 1421</span> </div>
<div class="line"><a id="l01422" name="l01422"></a><span class="lineno"> 1422</span>    assert((!sys_err_code) &amp;&amp; <span class="stringliteral">&quot;It should have returned false on truthy Error_code.&quot;</span>);</div>
<div class="line"><a id="l01423" name="l01423"></a><span class="lineno"> 1423</span>    <span class="keywordflow">if</span> <span class="keyword">constexpr</span>(S_SOCKET_STREAM_ENABLED)</div>
<div class="line"><a id="l01424" name="l01424"></a><span class="lineno"> 1424</span>    {</div>
<div class="line"><a id="l01425" name="l01425"></a><span class="lineno"> 1425</span>      <span class="keyword">static_assert</span>(std::is_same_v&lt;<a class="code hl_typedef" href="classipc_1_1session_1_1Server__session__impl.html#a7c969c3a1007f8e4ba3ad1c1acd6c290">Channel_obj</a>,</div>
<div class="line"><a id="l01426" name="l01426"></a><span class="lineno"> 1426</span>                                   Mqs_socket_stream_channel&lt;true, Persistent_mq_handle_from_cfg&gt;&gt;, <span class="stringliteral">&quot;Sanity check.&quot;</span>);</div>
<div class="line"><a id="l01427" name="l01427"></a><span class="lineno"> 1427</span>      <span class="keywordflow">if</span> (make_sock_stm_func())</div>
<div class="line"><a id="l01428" name="l01428"></a><span class="lineno"> 1428</span>      {</div>
<div class="line"><a id="l01429" name="l01429"></a><span class="lineno"> 1429</span>        opened_channel = <a class="code hl_typedef" href="classipc_1_1session_1_1Server__session__impl.html#a7c969c3a1007f8e4ba3ad1c1acd6c290">Channel_obj</a>(get_logger(), nickname, std::move(mq_s2c), std::move(mq_c2s),</div>
<div class="line"><a id="l01430" name="l01430"></a><span class="lineno"> 1430</span>                                     std::move(local_sock_stm_or_null), &amp;sys_err_code);</div>
<div class="line"><a id="l01431" name="l01431"></a><span class="lineno"> 1431</span>      }</div>
<div class="line"><a id="l01432" name="l01432"></a><span class="lineno"> 1432</span>      <span class="keywordflow">else</span></div>
<div class="line"><a id="l01433" name="l01433"></a><span class="lineno"> 1433</span>      {</div>
<div class="line"><a id="l01434" name="l01434"></a><span class="lineno"> 1434</span>        assert(sys_err_code); <span class="comment">// Handled a bit lower down.</span></div>
<div class="line"><a id="l01435" name="l01435"></a><span class="lineno"> 1435</span>      }</div>
<div class="line"><a id="l01436" name="l01436"></a><span class="lineno"> 1436</span>      <span class="comment">// Fall through.</span></div>
<div class="line"><a id="l01437" name="l01437"></a><span class="lineno"> 1437</span>    }</div>
<div class="line"><a id="l01438" name="l01438"></a><span class="lineno"> 1438</span>    <span class="keywordflow">else</span> <span class="comment">// if constexpr(!S_SOCKET_STREAM_ENABLED)</span></div>
<div class="line"><a id="l01439" name="l01439"></a><span class="lineno"> 1439</span>    {</div>
<div class="line"><a id="l01440" name="l01440"></a><span class="lineno"> 1440</span>      <span class="keyword">static_assert</span>(std::is_same_v&lt;<a class="code hl_typedef" href="classipc_1_1session_1_1Server__session__impl.html#a7c969c3a1007f8e4ba3ad1c1acd6c290">Channel_obj</a>,</div>
<div class="line"><a id="l01441" name="l01441"></a><span class="lineno"> 1441</span>                                   Mqs_channel&lt;true, Persistent_mq_handle_from_cfg&gt;&gt;, <span class="stringliteral">&quot;Sanity check.&quot;</span>);</div>
<div class="line"><a id="l01442" name="l01442"></a><span class="lineno"> 1442</span>      opened_channel = <a class="code hl_typedef" href="classipc_1_1session_1_1Server__session__impl.html#a7c969c3a1007f8e4ba3ad1c1acd6c290">Channel_obj</a>(get_logger(), nickname, std::move(mq_s2c), std::move(mq_c2s), &amp;sys_err_code);</div>
<div class="line"><a id="l01443" name="l01443"></a><span class="lineno"> 1443</span>    }</div>
<div class="line"><a id="l01444" name="l01444"></a><span class="lineno"> 1444</span> </div>
<div class="line"><a id="l01445" name="l01445"></a><span class="lineno"> 1445</span>    <span class="keywordflow">if</span> (sys_err_code)</div>
<div class="line"><a id="l01446" name="l01446"></a><span class="lineno"> 1446</span>    {</div>
<div class="line"><a id="l01447" name="l01447"></a><span class="lineno"> 1447</span>      <span class="comment">// Clean up the stuff that *was* created OK.  Use tactic from inside error path in make_channel_mqs().</span></div>
<div class="line"><a id="l01448" name="l01448"></a><span class="lineno"> 1448</span>      mq_c2s = <a class="code hl_typedef" href="classipc_1_1session_1_1Server__session__impl.html#aa72ad11c33a4d11d5e3f0480ce0a6ff1">Persistent_mq_handle_from_cfg</a>();</div>
<div class="line"><a id="l01449" name="l01449"></a><span class="lineno"> 1449</span>      mq_s2c = <a class="code hl_typedef" href="classipc_1_1session_1_1Server__session__impl.html#aa72ad11c33a4d11d5e3f0480ce0a6ff1">Persistent_mq_handle_from_cfg</a>();</div>
<div class="line"><a id="l01450" name="l01450"></a><span class="lineno"> 1450</span>      <a class="code hl_typedef" href="namespaceipc.html#aa3192e586cc45d3e7c22463bf2760f89">Error_code</a> ignored;</div>
<div class="line"><a id="l01451" name="l01451"></a><span class="lineno"> 1451</span>      Persistent_mq_handle_from_cfg::remove_persistent(get_logger(), mq_name_c2s_or_none, &amp;ignored);</div>
<div class="line"><a id="l01452" name="l01452"></a><span class="lineno"> 1452</span>      Persistent_mq_handle_from_cfg::remove_persistent(get_logger(), mq_name_s2c_or_none, &amp;ignored);</div>
<div class="line"><a id="l01453" name="l01453"></a><span class="lineno"> 1453</span> </div>
<div class="line"><a id="l01454" name="l01454"></a><span class="lineno"> 1454</span>      opened_channel = <a class="code hl_typedef" href="classipc_1_1session_1_1Server__session__impl.html#a7c969c3a1007f8e4ba3ad1c1acd6c290">Channel_obj</a>(); <span class="comment">// For cleanliness / no pointless threads sitting around....</span></div>
<div class="line"><a id="l01455" name="l01455"></a><span class="lineno"> 1455</span>      <span class="keywordflow">return</span> <span class="keyword">false</span>;</div>
<div class="line"><a id="l01456" name="l01456"></a><span class="lineno"> 1456</span>    }</div>
<div class="line"><a id="l01457" name="l01457"></a><span class="lineno"> 1457</span>    <span class="comment">// else { Yay! }</span></div>
<div class="line"><a id="l01458" name="l01458"></a><span class="lineno"> 1458</span>  } <span class="comment">// if constexpr(S_MQS_ENABLED)</span></div>
<div class="line"><a id="l01459" name="l01459"></a><span class="lineno"> 1459</span>  <span class="keywordflow">else</span> <span class="comment">// if constexpr(!S_MQS_ENABLED)</span></div>
<div class="line"><a id="l01460" name="l01460"></a><span class="lineno"> 1460</span>  {</div>
<div class="line"><a id="l01461" name="l01461"></a><span class="lineno"> 1461</span>    <span class="keyword">static_assert</span>(S_SOCKET_STREAM_ENABLED, <span class="stringliteral">&quot;Either MQs or socket stream or both must be configured on somehow.&quot;</span>);</div>
<div class="line"><a id="l01462" name="l01462"></a><span class="lineno"> 1462</span> </div>
<div class="line"><a id="l01463" name="l01463"></a><span class="lineno"> 1463</span>    <span class="keywordflow">if</span> (!make_sock_stm_func())</div>
<div class="line"><a id="l01464" name="l01464"></a><span class="lineno"> 1464</span>    {</div>
<div class="line"><a id="l01465" name="l01465"></a><span class="lineno"> 1465</span>      <span class="keywordflow">return</span> <span class="keyword">false</span>;</div>
<div class="line"><a id="l01466" name="l01466"></a><span class="lineno"> 1466</span>    }</div>
<div class="line"><a id="l01467" name="l01467"></a><span class="lineno"> 1467</span>    <span class="comment">// else</span></div>
<div class="line"><a id="l01468" name="l01468"></a><span class="lineno"> 1468</span> </div>
<div class="line"><a id="l01469" name="l01469"></a><span class="lineno"> 1469</span>    <span class="keywordflow">if</span> <span class="keyword">constexpr</span>(S_TRANSMIT_NATIVE_HANDLES)</div>
<div class="line"><a id="l01470" name="l01470"></a><span class="lineno"> 1470</span>    {</div>
<div class="line"><a id="l01471" name="l01471"></a><span class="lineno"> 1471</span>      <span class="keyword">static_assert</span>(std::is_same_v&lt;Channel_obj, Socket_stream_channel&lt;true&gt;&gt;, <span class="stringliteral">&quot;Sanity check.&quot;</span>);</div>
<div class="line"><a id="l01472" name="l01472"></a><span class="lineno"> 1472</span>      opened_channel = <a class="code hl_typedef" href="classipc_1_1session_1_1Server__session__impl.html#a7c969c3a1007f8e4ba3ad1c1acd6c290">Channel_obj</a>(get_logger(), nickname, std::move(local_sock_stm_or_null)); <span class="comment">// Yay!</span></div>
<div class="line"><a id="l01473" name="l01473"></a><span class="lineno"> 1473</span>    }</div>
<div class="line"><a id="l01474" name="l01474"></a><span class="lineno"> 1474</span>    <span class="keywordflow">else</span></div>
<div class="line"><a id="l01475" name="l01475"></a><span class="lineno"> 1475</span>    {</div>
<div class="line"><a id="l01476" name="l01476"></a><span class="lineno"> 1476</span>      <span class="keyword">static_assert</span>(std::is_same_v&lt;Channel_obj, Socket_stream_channel_of_blobs&lt;true&gt;&gt;, <span class="stringliteral">&quot;Sanity check.&quot;</span>);</div>
<div class="line"><a id="l01477" name="l01477"></a><span class="lineno"> 1477</span>      opened_channel = <a class="code hl_typedef" href="classipc_1_1session_1_1Server__session__impl.html#a7c969c3a1007f8e4ba3ad1c1acd6c290">Channel_obj</a>(get_logger(), nickname, std::move(local_sock_stm_or_null)); <span class="comment">// Yay!</span></div>
<div class="line"><a id="l01478" name="l01478"></a><span class="lineno"> 1478</span>    }</div>
<div class="line"><a id="l01479" name="l01479"></a><span class="lineno"> 1479</span>  } <span class="comment">// else if constexpr(!S_MQS_ENABLED)</span></div>
<div class="line"><a id="l01480" name="l01480"></a><span class="lineno"> 1480</span> </div>
<div class="line"><a id="l01481" name="l01481"></a><span class="lineno"> 1481</span>  <span class="keywordflow">return</span> <span class="keyword">true</span>;</div>
<div class="line"><a id="l01482" name="l01482"></a><span class="lineno"> 1482</span>} <span class="comment">// Server_session_impl::create_channel_and_resources()</span></div>
<div class="line"><a id="l01483" name="l01483"></a><span class="lineno"> 1483</span> </div>
<div class="line"><a id="l01484" name="l01484"></a><span class="lineno"> 1484</span><a class="code hl_define" href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp.html#aea842eaa966995a5ff8abf5672a25a5f">TEMPLATE_SRV_SESSION_IMPL</a></div>
<div class="line"><a id="l01485" name="l01485"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#a84d54a57d3e06c064cde737d1f4be472"> 1485</a></span><span class="keywordtype">bool</span> CLASS_SRV_SESSION_IMPL::make_channel_mqs(<a class="code hl_typedef" href="classipc_1_1session_1_1Server__session__impl.html#aa72ad11c33a4d11d5e3f0480ce0a6ff1">Persistent_mq_handle_from_cfg</a>* mq_c2s,</div>
<div class="line"><a id="l01486" name="l01486"></a><span class="lineno"> 1486</span>                                              <a class="code hl_typedef" href="classipc_1_1session_1_1Server__session__impl.html#aa72ad11c33a4d11d5e3f0480ce0a6ff1">Persistent_mq_handle_from_cfg</a>* mq_s2c,</div>
<div class="line"><a id="l01487" name="l01487"></a><span class="lineno"> 1487</span>                                              <a class="code hl_class" href="classipc_1_1util_1_1Shared__name.html">Shared_name</a>* mq_name_c2s, <a class="code hl_class" href="classipc_1_1util_1_1Shared__name.html">Shared_name</a>* mq_name_s2c,</div>
<div class="line"><a id="l01488" name="l01488"></a><span class="lineno"> 1488</span>                                              <a class="code hl_typedef" href="namespaceipc.html#aa3192e586cc45d3e7c22463bf2760f89">Error_code</a>* err_code)</div>
<div class="line"><a id="l01489" name="l01489"></a><span class="lineno"> 1489</span>{</div>
<div class="line"><a id="l01490" name="l01490"></a><span class="lineno"> 1490</span>  <span class="keyword">using </span>std::to_string;</div>
<div class="line"><a id="l01491" name="l01491"></a><span class="lineno"> 1491</span> </div>
<div class="line"><a id="l01492" name="l01492"></a><span class="lineno"> 1492</span>  assert(mq_c2s &amp;&amp; mq_s2c);</div>
<div class="line"><a id="l01493" name="l01493"></a><span class="lineno"> 1493</span>  assert(err_code);</div>
<div class="line"><a id="l01494" name="l01494"></a><span class="lineno"> 1494</span> </div>
<div class="line"><a id="l01495" name="l01495"></a><span class="lineno"> 1495</span>  <span class="comment">/* By default in Linux POSIX MQs this happens to be the actual limit for # of unread messages --</span></div>
<div class="line"><a id="l01496" name="l01496"></a><span class="lineno"> 1496</span><span class="comment">   * visible in /proc/sys/fs/mqueue/msg_max -- so we cannot go higher typically.  However that file can be modified.</span></div>
<div class="line"><a id="l01497" name="l01497"></a><span class="lineno"> 1497</span><span class="comment">   * For now let&#39;s assume a typical environment.</span></div>
<div class="line"><a id="l01498" name="l01498"></a><span class="lineno"> 1498</span><span class="comment">   * @todo Persistent_mq_handle_from_cfg might be actually bipc MQ, with no such limit, though.  So we&#39;re (1)</span></div>
<div class="line"><a id="l01499" name="l01499"></a><span class="lineno"> 1499</span><span class="comment">   * assuming a certain default and (2) taking POSIX MQs as the lowest common denominator (metaphorically speaking).</span></div>
<div class="line"><a id="l01500" name="l01500"></a><span class="lineno"> 1500</span><span class="comment">   * So really this could be something else in that case.  Reconsider / make configurable / etc.  Might also use the</span></div>
<div class="line"><a id="l01501" name="l01501"></a><span class="lineno"> 1501</span><span class="comment">   * default /proc/sys/fs/mqueue/msg_default which is possible using a certain mq_ API.  Likely such niceties would</span></div>
<div class="line"><a id="l01502" name="l01502"></a><span class="lineno"> 1502</span><span class="comment">   * be factored out into Persistent_mq_handle concept API as opposed to litigated here.</span></div>
<div class="line"><a id="l01503" name="l01503"></a><span class="lineno"> 1503</span><span class="comment">   *</span></div>
<div class="line"><a id="l01504" name="l01504"></a><span class="lineno"> 1504</span><span class="comment">   * To be clear: the transport:: MQ stuff above the lowest (Persistent_mq_handle) level will seamlessly handle</span></div>
<div class="line"><a id="l01505" name="l01505"></a><span class="lineno"> 1505</span><span class="comment">   * any would-block situation due to reaching this limit.  In theory it could affect perf. */</span></div>
<div class="line"><a id="l01506" name="l01506"></a><span class="lineno"> 1506</span>  <span class="keyword">constexpr</span> <span class="keywordtype">size_t</span> MAX_N_MSG = 10;</div>
<div class="line"><a id="l01507" name="l01507"></a><span class="lineno"> 1507</span> </div>
<div class="line"><a id="l01508" name="l01508"></a><span class="lineno"> 1508</span>  <span class="comment">/* We must also decide the max message of each size.  If SHM-backing is disabled, then there&#39;s no question:</span></div>
<div class="line"><a id="l01509" name="l01509"></a><span class="lineno"> 1509</span><span class="comment">   * we have to use Base::S_MQS_MAX_MSG_SZ which (see its doc header) respects both the need to be as large</span></div>
<div class="line"><a id="l01510" name="l01510"></a><span class="lineno"> 1510</span><span class="comment">   * as possible to support the widest variety of user payloads; and the (POSIX-MQ-relevant) system limit(s) as</span></div>
<div class="line"><a id="l01511" name="l01511"></a><span class="lineno"> 1511</span><span class="comment">   * to the message size.  If SHM-backing is enabled, it is tempting to simply use the same value... why not,</span></div>
<div class="line"><a id="l01512" name="l01512"></a><span class="lineno"> 1512</span><span class="comment">   * right?  Good enough for the heap-backed case; why not the SHM-backed case?  At worst it only wastes some</span></div>
<div class="line"><a id="l01513" name="l01513"></a><span class="lineno"> 1513</span><span class="comment">   * RAM, since each message transmitted over MQ contains merely a tiny SHM handle, right?  Yes and no:</span></div>
<div class="line"><a id="l01514" name="l01514"></a><span class="lineno"> 1514</span><span class="comment">   * For bipc MQs, yes; but POSIX MQs impose yet another limit: A given process trying to maintain a *total*</span></div>
<div class="line"><a id="l01515" name="l01515"></a><span class="lineno"> 1515</span><span class="comment">   * of X bytes of MQs at a given time (the &quot;total&quot; roughly meaning the sum of `MAX_N_MSG x max_msg_sz` for</span></div>
<div class="line"><a id="l01516" name="l01516"></a><span class="lineno"> 1516</span><span class="comment">   * all then-opened MQs) will yield too-many-files (Linux errno=EMFILES) once X is exceeded.  A typical value</span></div>
<div class="line"><a id="l01517" name="l01517"></a><span class="lineno"> 1517</span><span class="comment">   * for this is 819,200 -- or up to only *ten* MAX_N_MSxMQS_MAX_MSG_SZ such MQs opened simultaneously.</span></div>
<div class="line"><a id="l01518" name="l01518"></a><span class="lineno"> 1518</span><span class="comment">   * This is in practice easily exceeded.  On the other hand, suppose we instead use S_SHM_MAX_HNDL_SZ</span></div>
<div class="line"><a id="l01519" name="l01519"></a><span class="lineno"> 1519</span><span class="comment">   * instead of MQS_MAX_MSG_SZ -- which is sufficient, since we&#39;ll only be sending SHM handles, not the actual</span></div>
<div class="line"><a id="l01520" name="l01520"></a><span class="lineno"> 1520</span><span class="comment">   * data.  As of this writing it&#39;s 64; so that&#39;s 8,192/64=128 *times* the number of MQs creatable this way;</span></div>
<div class="line"><a id="l01521" name="l01521"></a><span class="lineno"> 1521</span><span class="comment">   * errno=EMFILES occurs not after 10 MQs now but after 1,280 such MQs.  Much more reasonable.</span></div>
<div class="line"><a id="l01522" name="l01522"></a><span class="lineno"> 1522</span><span class="comment">   * Trust me (ygoldfel): the ~10-MQ limit can be quite annoying. */</span></div>
<div class="line"><a id="l01523" name="l01523"></a><span class="lineno"> 1523</span>  <span class="keywordtype">size_t</span> max_msg_sz;</div>
<div class="line"><a id="l01524" name="l01524"></a><span class="lineno"> 1524</span>  <span class="keywordflow">if</span> <span class="keyword">constexpr</span>(S_SHM_ENABLED)</div>
<div class="line"><a id="l01525" name="l01525"></a><span class="lineno"> 1525</span>  {</div>
<div class="line"><a id="l01526" name="l01526"></a><span class="lineno"> 1526</span>    max_msg_sz = S_SHM_MAX_HNDL_SZ;</div>
<div class="line"><a id="l01527" name="l01527"></a><span class="lineno"> 1527</span>  }</div>
<div class="line"><a id="l01528" name="l01528"></a><span class="lineno"> 1528</span>  <span class="keywordflow">else</span></div>
<div class="line"><a id="l01529" name="l01529"></a><span class="lineno"> 1529</span>  {</div>
<div class="line"><a id="l01530" name="l01530"></a><span class="lineno"> 1530</span>    max_msg_sz = Base::S_MQS_MAX_MSG_SZ;</div>
<div class="line"><a id="l01531" name="l01531"></a><span class="lineno"> 1531</span>  }</div>
<div class="line"><a id="l01532" name="l01532"></a><span class="lineno"> 1532</span> </div>
<div class="line"><a id="l01533" name="l01533"></a><span class="lineno"> 1533</span>  ++m_last_channel_mq_id;</div>
<div class="line"><a id="l01534" name="l01534"></a><span class="lineno"> 1534</span> </div>
<div class="line"><a id="l01535" name="l01535"></a><span class="lineno"> 1535</span>  <span class="keyword">const</span> <span class="keyword">auto</span> mq_name_func = [&amp;](<span class="keywordtype">bool</span> c2s) -&gt; <a class="code hl_class" href="classipc_1_1util_1_1Shared__name.html">Shared_name</a></div>
<div class="line"><a id="l01536" name="l01536"></a><span class="lineno"> 1536</span>  {</div>
<div class="line"><a id="l01537" name="l01537"></a><span class="lineno"> 1537</span>    <span class="comment">// Session scope.</span></div>
<div class="line"><a id="l01538" name="l01538"></a><span class="lineno"> 1538</span>    <span class="keyword">auto</span> mq_name = <a class="code hl_function" href="namespaceipc_1_1session.html#a365d2d63f77b738e67e206af6b702634">build_conventional_shared_name</a>(Persistent_mq_handle_from_cfg::S_RESOURCE_TYPE_ID,</div>
<div class="line"><a id="l01539" name="l01539"></a><span class="lineno"> 1539</span>                                                  <a class="code hl_function" href="classipc_1_1util_1_1Shared__name.html#a48f20b7b54490aa10dc64081d34c55b2">Shared_name::ct</a>(Base::m_srv_app_ref.m_name),</div>
<div class="line"><a id="l01540" name="l01540"></a><span class="lineno"> 1540</span>                                                  Base::srv_namespace(),</div>
<div class="line"><a id="l01541" name="l01541"></a><span class="lineno"> 1541</span>                                                  <a class="code hl_function" href="classipc_1_1util_1_1Shared__name.html#a48f20b7b54490aa10dc64081d34c55b2">Shared_name::ct</a>(Base::cli_app_ptr()-&gt;m_name),</div>
<div class="line"><a id="l01542" name="l01542"></a><span class="lineno"> 1542</span>                                                  Base::cli_namespace());</div>
<div class="line"><a id="l01543" name="l01543"></a><span class="lineno"> 1543</span>    <span class="comment">// That was the standard stuff.  Now the us-specific stuff:</span></div>
<div class="line"><a id="l01544" name="l01544"></a><span class="lineno"> 1544</span>    mq_name /= c2s ? <span class="stringliteral">&quot;c2s&quot;</span> : <span class="stringliteral">&quot;s2c&quot;</span>;</div>
<div class="line"><a id="l01545" name="l01545"></a><span class="lineno"> 1545</span>    mq_name /= to_string(m_last_channel_mq_id);</div>
<div class="line"><a id="l01546" name="l01546"></a><span class="lineno"> 1546</span>    <span class="keywordflow">return</span> mq_name;</div>
<div class="line"><a id="l01547" name="l01547"></a><span class="lineno"> 1547</span>  }; <span class="comment">// mq_name_func =</span></div>
<div class="line"><a id="l01548" name="l01548"></a><span class="lineno"> 1548</span> </div>
<div class="line"><a id="l01549" name="l01549"></a><span class="lineno"> 1549</span>  <span class="comment">// These ctors should log in any case.</span></div>
<div class="line"><a id="l01550" name="l01550"></a><span class="lineno"> 1550</span> </div>
<div class="line"><a id="l01551" name="l01551"></a><span class="lineno"> 1551</span>  <span class="keyword">const</span> <span class="keyword">auto</span> perms = <a class="code hl_function" href="namespaceipc_1_1util.html#abda2ce5bcdbc26ca63d667b87818439c">util::shared_resource_permissions</a>(Base::m_srv_app_ref.m_permissions_level_for_client_apps);</div>
<div class="line"><a id="l01552" name="l01552"></a><span class="lineno"> 1552</span> </div>
<div class="line"><a id="l01553" name="l01553"></a><span class="lineno"> 1553</span>  *mq_c2s = <a class="code hl_typedef" href="classipc_1_1session_1_1Server__session__impl.html#aa72ad11c33a4d11d5e3f0480ce0a6ff1">Persistent_mq_handle_from_cfg</a>(get_logger(), mq_name_func(<span class="keyword">true</span>), <a class="code hl_variable" href="namespaceipc_1_1util.html#ad1ca1cab79a35e1eb1c47037a0973cd8">util::CREATE_ONLY</a>,</div>
<div class="line"><a id="l01554" name="l01554"></a><span class="lineno"> 1554</span>                                          MAX_N_MSG, max_msg_sz, perms, err_code);</div>
<div class="line"><a id="l01555" name="l01555"></a><span class="lineno"> 1555</span>  <span class="keywordflow">if</span> (*err_code)</div>
<div class="line"><a id="l01556" name="l01556"></a><span class="lineno"> 1556</span>  {</div>
<div class="line"><a id="l01557" name="l01557"></a><span class="lineno"> 1557</span>    --m_last_channel_mq_id; <span class="comment">// Might as well.</span></div>
<div class="line"><a id="l01558" name="l01558"></a><span class="lineno"> 1558</span>    <span class="keywordflow">return</span> <span class="keyword">false</span>;</div>
<div class="line"><a id="l01559" name="l01559"></a><span class="lineno"> 1559</span>  }</div>
<div class="line"><a id="l01560" name="l01560"></a><span class="lineno"> 1560</span>  <span class="comment">// else</span></div>
<div class="line"><a id="l01561" name="l01561"></a><span class="lineno"> 1561</span>  *mq_s2c = <a class="code hl_typedef" href="classipc_1_1session_1_1Server__session__impl.html#aa72ad11c33a4d11d5e3f0480ce0a6ff1">Persistent_mq_handle_from_cfg</a>(get_logger(), mq_name_func(<span class="keyword">false</span>), <a class="code hl_variable" href="namespaceipc_1_1util.html#ad1ca1cab79a35e1eb1c47037a0973cd8">util::CREATE_ONLY</a>,</div>
<div class="line"><a id="l01562" name="l01562"></a><span class="lineno"> 1562</span>                                          MAX_N_MSG, max_msg_sz, perms, err_code);</div>
<div class="line"><a id="l01563" name="l01563"></a><span class="lineno"> 1563</span>  <span class="keywordflow">if</span> (*err_code)</div>
<div class="line"><a id="l01564" name="l01564"></a><span class="lineno"> 1564</span>  {</div>
<div class="line"><a id="l01565" name="l01565"></a><span class="lineno"> 1565</span>    --m_last_channel_mq_id; <span class="comment">// Might as well.</span></div>
<div class="line"><a id="l01566" name="l01566"></a><span class="lineno"> 1566</span>    <span class="keyword">const</span> <span class="keyword">auto</span> name = mq_c2s-&gt;absolute_name();</div>
<div class="line"><a id="l01567" name="l01567"></a><span class="lineno"> 1567</span>    *mq_c2s = <a class="code hl_typedef" href="classipc_1_1session_1_1Server__session__impl.html#aa72ad11c33a4d11d5e3f0480ce0a6ff1">Persistent_mq_handle_from_cfg</a>(); <span class="comment">// Close the first guy; won&#39;t be used.</span></div>
<div class="line"><a id="l01568" name="l01568"></a><span class="lineno"> 1568</span>    <a class="code hl_typedef" href="namespaceipc.html#aa3192e586cc45d3e7c22463bf2760f89">Error_code</a> ignored; <span class="comment">// Don&#39;t forget to remove underlying MQ we&#39;d successfully created.</span></div>
<div class="line"><a id="l01569" name="l01569"></a><span class="lineno"> 1569</span>    Persistent_mq_handle_from_cfg::remove_persistent(get_logger(), name, &amp;ignored);</div>
<div class="line"><a id="l01570" name="l01570"></a><span class="lineno"> 1570</span>    <span class="keywordflow">return</span> <span class="keyword">false</span>;</div>
<div class="line"><a id="l01571" name="l01571"></a><span class="lineno"> 1571</span>  }</div>
<div class="line"><a id="l01572" name="l01572"></a><span class="lineno"> 1572</span>  <span class="comment">// else</span></div>
<div class="line"><a id="l01573" name="l01573"></a><span class="lineno"> 1573</span>  *mq_name_c2s = mq_c2s-&gt;absolute_name();</div>
<div class="line"><a id="l01574" name="l01574"></a><span class="lineno"> 1574</span>  *mq_name_s2c = mq_s2c-&gt;absolute_name();</div>
<div class="line"><a id="l01575" name="l01575"></a><span class="lineno"> 1575</span>  <span class="keywordflow">return</span> <span class="keyword">true</span>;</div>
<div class="line"><a id="l01576" name="l01576"></a><span class="lineno"> 1576</span>} <span class="comment">// Server_session_impl::make_channel_mqs()</span></div>
<div class="line"><a id="l01577" name="l01577"></a><span class="lineno"> 1577</span> </div>
<div class="line"><a id="l01578" name="l01578"></a><span class="lineno"> 1578</span><a class="code hl_define" href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp.html#aea842eaa966995a5ff8abf5672a25a5f">TEMPLATE_SRV_SESSION_IMPL</a></div>
<div class="line"><a id="l01579" name="l01579"></a><span class="lineno"> 1579</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span> Session_server_impl_t,</div>
<div class="line"><a id="l01580" name="l01580"></a><span class="lineno"> 1580</span>         <span class="keyword">typename</span> Task_err, <span class="keyword">typename</span> Cli_app_lookup_func, <span class="keyword">typename</span> Cli_namespace_func, <span class="keyword">typename</span> Pre_rsp_setup_func,</div>
<div class="line"><a id="l01581" name="l01581"></a><span class="lineno"> 1581</span>         <span class="keyword">typename</span> N_init_channels_by_srv_req_func, <span class="keyword">typename</span> Mdt_load_func&gt;</div>
<div class="line"><a id="l01582" name="l01582"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#aee35d521d9997d48f6b5565730e60e93"> 1582</a></span><span class="keywordtype">void</span> CLASS_SRV_SESSION_IMPL::async_accept_log_in</div>
<div class="line"><a id="l01583" name="l01583"></a><span class="lineno"> 1583</span>       (Session_server_impl_t*,</div>
<div class="line"><a id="l01584" name="l01584"></a><span class="lineno"> 1584</span>        <span class="comment">// (^-- Unused here; but it&#39;s a customization point across multiple class templates.)</span></div>
<div class="line"><a id="l01585" name="l01585"></a><span class="lineno"> 1585</span>        <a class="code hl_typedef" href="classipc_1_1session_1_1Server__session__impl.html#a75df7061f9c57660f9fb944d83da416b">Channels</a>* init_channels_by_srv_req, <a class="code hl_typedef" href="classipc_1_1session_1_1Server__session__impl.html#a78e61f8681c7ec92fa19bae560763ab1">Mdt_reader_ptr</a>* mdt_from_cli_or_null, <a class="code hl_typedef" href="classipc_1_1session_1_1Server__session__impl.html#a75df7061f9c57660f9fb944d83da416b">Channels</a>* init_channels_by_cli_req,</div>
<div class="line"><a id="l01586" name="l01586"></a><span class="lineno"> 1586</span>        Cli_app_lookup_func&amp;&amp; cli_app_lookup_func, Cli_namespace_func&amp;&amp; cli_namespace_func,</div>
<div class="line"><a id="l01587" name="l01587"></a><span class="lineno"> 1587</span>        Pre_rsp_setup_func&amp;&amp; pre_rsp_setup_func,</div>
<div class="line"><a id="l01588" name="l01588"></a><span class="lineno"> 1588</span>        N_init_channels_by_srv_req_func&amp;&amp; n_init_channels_by_srv_req_func, Mdt_load_func&amp;&amp; mdt_load_func,</div>
<div class="line"><a id="l01589" name="l01589"></a><span class="lineno"> 1589</span>        Task_err&amp;&amp; on_done_func)</div>
<div class="line"><a id="l01590" name="l01590"></a><span class="lineno"> 1590</span>{</div>
<div class="line"><a id="l01591" name="l01591"></a><span class="lineno"> 1591</span>  <span class="keyword">using </span><a class="code hl_class" href="classipc_1_1util_1_1Process__credentials.html">util::Process_credentials</a>;</div>
<div class="line"><a id="l01592" name="l01592"></a><span class="lineno"> 1592</span>  <span class="keyword">using </span>flow::async::Task_asio_err;</div>
<div class="line"><a id="l01593" name="l01593"></a><span class="lineno"> 1593</span>  <span class="keyword">using </span>flow::util::ostream_op_string;</div>
<div class="line"><a id="l01594" name="l01594"></a><span class="lineno"> 1594</span>  <span class="keyword">using </span>boost::make_shared;</div>
<div class="line"><a id="l01595" name="l01595"></a><span class="lineno"> 1595</span>  <span class="keyword">using </span>boost::shared_ptr;</div>
<div class="line"><a id="l01596" name="l01596"></a><span class="lineno"> 1596</span>  <span class="keyword">using </span>std::string;</div>
<div class="line"><a id="l01597" name="l01597"></a><span class="lineno"> 1597</span> </div>
<div class="line"><a id="l01598" name="l01598"></a><span class="lineno"> 1598</span>  <span class="comment">// We are in thread U.</span></div>
<div class="line"><a id="l01599" name="l01599"></a><span class="lineno"> 1599</span> </div>
<div class="line"><a id="l01600" name="l01600"></a><span class="lineno"> 1600</span>  <span class="comment">// Reminder: We are protected -- not public -- and can only be called *once*.</span></div>
<div class="line"><a id="l01601" name="l01601"></a><span class="lineno"> 1601</span> </div>
<div class="line"><a id="l01602" name="l01602"></a><span class="lineno"> 1602</span>  m_log_in_on_done_func = std::move(on_done_func); <span class="comment">// May be invoked from thread W or thread U (dtor) (it&#39;s a race).</span></div>
<div class="line"><a id="l01603" name="l01603"></a><span class="lineno"> 1603</span> </div>
<div class="line"><a id="l01604" name="l01604"></a><span class="lineno"> 1604</span>  <span class="comment">// Kick off all work from thread W to avoid concurrency.</span></div>
<div class="line"><a id="l01605" name="l01605"></a><span class="lineno"> 1605</span>  m_async_worker.post([<span class="keyword">this</span>,</div>
<div class="line"><a id="l01606" name="l01606"></a><span class="lineno"> 1606</span>                       init_channels_by_srv_req, mdt_from_cli_or_null, init_channels_by_cli_req,</div>
<div class="line"><a id="l01607" name="l01607"></a><span class="lineno"> 1607</span>                       cli_app_lookup_func = std::move(cli_app_lookup_func),</div>
<div class="line"><a id="l01608" name="l01608"></a><span class="lineno"> 1608</span>                       cli_namespace_func = std::move(cli_namespace_func),</div>
<div class="line"><a id="l01609" name="l01609"></a><span class="lineno"> 1609</span>                       pre_rsp_setup_func = std::move(pre_rsp_setup_func),</div>
<div class="line"><a id="l01610" name="l01610"></a><span class="lineno"> 1610</span>                       n_init_channels_by_srv_req_func = std::move(n_init_channels_by_srv_req_func),</div>
<div class="line"><a id="l01611" name="l01611"></a><span class="lineno"> 1611</span>                       mdt_load_func = std::move(mdt_load_func)]</div>
<div class="line"><a id="l01612" name="l01612"></a><span class="lineno"> 1612</span>                        () <span class="keyword">mutable</span></div>
<div class="line"><a id="l01613" name="l01613"></a><span class="lineno"> 1613</span>  {</div>
<div class="line"><a id="l01614" name="l01614"></a><span class="lineno"> 1614</span>    <span class="comment">// We are in thread W.</span></div>
<div class="line"><a id="l01615" name="l01615"></a><span class="lineno"> 1615</span> </div>
<div class="line"><a id="l01616" name="l01616"></a><span class="lineno"> 1616</span>    <span class="comment">/* We&#39;ll want to check these OS-reported remote-process credentials against something during the log-in</span></div>
<div class="line"><a id="l01617" name="l01617"></a><span class="lineno"> 1617</span><span class="comment">     * procedure that is coming next; per remote_peer_process_credentials() doc header it&#39;s best to call it</span></div>
<div class="line"><a id="l01618" name="l01618"></a><span class="lineno"> 1618</span><span class="comment">     * first-thing (before traffic if possible) so let&#39;s. */</span></div>
<div class="line"><a id="l01619" name="l01619"></a><span class="lineno"> 1619</span>    <a class="code hl_typedef" href="namespaceipc.html#aa3192e586cc45d3e7c22463bf2760f89">Error_code</a> err_code;</div>
<div class="line"><a id="l01620" name="l01620"></a><span class="lineno"> 1620</span>    <span class="keywordtype">string</span> os_proc_invoked_as;</div>
<div class="line"><a id="l01621" name="l01621"></a><span class="lineno"> 1621</span>    <span class="keyword">const</span> <span class="keyword">auto</span> os_proc_creds = m_master_sock_stm.remote_peer_process_credentials(&amp;err_code);</div>
<div class="line"><a id="l01622" name="l01622"></a><span class="lineno"> 1622</span>    <span class="keywordflow">if</span> (err_code)</div>
<div class="line"><a id="l01623" name="l01623"></a><span class="lineno"> 1623</span>    {</div>
<div class="line"><a id="l01624" name="l01624"></a><span class="lineno"> 1624</span>      FLOW_LOG_WARNING(<span class="stringliteral">&quot;Server session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Accept-log-in request: We have the freshly-accepted &quot;</span></div>
<div class="line"><a id="l01625" name="l01625"></a><span class="lineno"> 1625</span>                       <span class="stringliteral">&quot;master socket stream [&quot;</span> &lt;&lt; m_master_sock_stm &lt;&lt; <span class="stringliteral">&quot;]; but &quot;</span></div>
<div class="line"><a id="l01626" name="l01626"></a><span class="lineno"> 1626</span>                       <span class="stringliteral">&quot;then obtaining OS-reported peer process credentials immediately failed: &quot;</span></div>
<div class="line"><a id="l01627" name="l01627"></a><span class="lineno"> 1627</span>                       <span class="stringliteral">&quot;[&quot;</span> &lt;&lt; err_code &lt;&lt; <span class="stringliteral">&quot;] [&quot;</span> &lt;&lt; err_code.message() &lt;&lt; <span class="stringliteral">&quot;].  Shall close stream and execute handler.&quot;</span>);</div>
<div class="line"><a id="l01628" name="l01628"></a><span class="lineno"> 1628</span>    }</div>
<div class="line"><a id="l01629" name="l01629"></a><span class="lineno"> 1629</span>    <span class="keywordflow">else</span> <span class="keywordflow">if</span> (os_proc_invoked_as = os_proc_creds.process_invoked_as(&amp;err_code), err_code) <span class="comment">// Check err_code result....</span></div>
<div class="line"><a id="l01630" name="l01630"></a><span class="lineno"> 1630</span>    {</div>
<div class="line"><a id="l01631" name="l01631"></a><span class="lineno"> 1631</span>      FLOW_LOG_WARNING(<span class="stringliteral">&quot;Server session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Accept-log-in request: We have the freshly-accepted &quot;</span></div>
<div class="line"><a id="l01632" name="l01632"></a><span class="lineno"> 1632</span>                       <span class="stringliteral">&quot;master socket stream [&quot;</span> &lt;&lt; m_master_sock_stm &lt;&lt; <span class="stringliteral">&quot;]; and &quot;</span></div>
<div class="line"><a id="l01633" name="l01633"></a><span class="lineno"> 1633</span>                       <span class="stringliteral">&quot;then obtaining OS-reported peer process credentials immediately succeded yielding &quot;</span></div>
<div class="line"><a id="l01634" name="l01634"></a><span class="lineno"> 1634</span>                       <span class="stringliteral">&quot;[&quot;</span> &lt;&lt; os_proc_creds &lt;&lt; <span class="stringliteral">&quot;], but trying to query the executable-invoked-as (binary name) &quot;</span></div>
<div class="line"><a id="l01635" name="l01635"></a><span class="lineno"> 1635</span>                       <span class="stringliteral">&quot;value failed ([&quot;</span> &lt;&lt; err_code &lt;&lt; <span class="stringliteral">&quot;] [&quot;</span> &lt;&lt; err_code.message() &lt;&lt; <span class="stringliteral">&quot;]) (e.g., is it still &quot;</span></div>
<div class="line"><a id="l01636" name="l01636"></a><span class="lineno"> 1636</span>                       <span class="stringliteral">&quot;running?).  Shall close stream and execute handler.&quot;</span>);</div>
<div class="line"><a id="l01637" name="l01637"></a><span class="lineno"> 1637</span>    }</div>
<div class="line"><a id="l01638" name="l01638"></a><span class="lineno"> 1638</span>    <span class="comment">// else { err_code is still falsy. }</span></div>
<div class="line"><a id="l01639" name="l01639"></a><span class="lineno"> 1639</span> </div>
<div class="line"><a id="l01640" name="l01640"></a><span class="lineno"> 1640</span>    <span class="keywordflow">if</span> (err_code)</div>
<div class="line"><a id="l01641" name="l01641"></a><span class="lineno"> 1641</span>    {</div>
<div class="line"><a id="l01642" name="l01642"></a><span class="lineno"> 1642</span>      <span class="comment">// Might as well do it now instead of waiting for dtor (kind of consistent with m_master_channel.reset() below).</span></div>
<div class="line"><a id="l01643" name="l01643"></a><span class="lineno"> 1643</span>      m_master_sock_stm = <a class="code hl_class" href="classipc_1_1transport_1_1sync__io_1_1Native__socket__stream.html">transport::sync_io::Native_socket_stream</a>();</div>
<div class="line"><a id="l01644" name="l01644"></a><span class="lineno"> 1644</span> </div>
<div class="line"><a id="l01645" name="l01645"></a><span class="lineno"> 1645</span>      m_log_in_on_done_func(err_code);</div>
<div class="line"><a id="l01646" name="l01646"></a><span class="lineno"> 1646</span>      FLOW_LOG_TRACE(<span class="stringliteral">&quot;Handler finished.&quot;</span>);</div>
<div class="line"><a id="l01647" name="l01647"></a><span class="lineno"> 1647</span>      m_log_in_on_done_func.clear();</div>
<div class="line"><a id="l01648" name="l01648"></a><span class="lineno"> 1648</span>      <span class="keywordflow">return</span>;</div>
<div class="line"><a id="l01649" name="l01649"></a><span class="lineno"> 1649</span>    }</div>
<div class="line"><a id="l01650" name="l01650"></a><span class="lineno"> 1650</span>    <span class="comment">// else</span></div>
<div class="line"><a id="l01651" name="l01651"></a><span class="lineno"> 1651</span> </div>
<div class="line"><a id="l01652" name="l01652"></a><span class="lineno"> 1652</span>    FLOW_LOG_INFO(<span class="stringliteral">&quot;Server session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Accept-log-in request: We have the freshly-accepted &quot;</span></div>
<div class="line"><a id="l01653" name="l01653"></a><span class="lineno"> 1653</span>                  <span class="stringliteral">&quot;master socket stream [&quot;</span> &lt;&lt; m_master_sock_stm &lt;&lt; <span class="stringliteral">&quot;]; &quot;</span></div>
<div class="line"><a id="l01654" name="l01654"></a><span class="lineno"> 1654</span>                  <span class="stringliteral">&quot;wrapping in 1-pipe Channel; then wrapping that in a direct-heap-serializing struc::Channel; &quot;</span></div>
<div class="line"><a id="l01655" name="l01655"></a><span class="lineno"> 1655</span>                  <span class="stringliteral">&quot;then waiting until log-in request arrives; and only then we will send response, at which point &quot;</span></div>
<div class="line"><a id="l01656" name="l01656"></a><span class="lineno"> 1656</span>                  <span class="stringliteral">&quot;we will issue the user handler indicating the session is ready.&quot;</span>);</div>
<div class="line"><a id="l01657" name="l01657"></a><span class="lineno"> 1657</span> </div>
<div class="line"><a id="l01658" name="l01658"></a><span class="lineno"> 1658</span>    <a class="code hl_class" href="classipc_1_1transport_1_1Socket__stream__channel.html">transport::Socket_stream_channel&lt;true&gt;</a></div>
<div class="line"><a id="l01659" name="l01659"></a><span class="lineno"> 1659</span>      unstructured_master_channel(get_logger(), ostream_op_string(<span class="stringliteral">&quot;smc-&quot;</span>, *<span class="keyword">this</span>),</div>
<div class="line"><a id="l01660" name="l01660"></a><span class="lineno"> 1660</span>                                  std::move(m_master_sock_stm));</div>
<div class="line"><a id="l01661" name="l01661"></a><span class="lineno"> 1661</span>    {</div>
<div class="line"><a id="l01662" name="l01662"></a><span class="lineno"> 1662</span>      <span class="keyword">const</span> <span class="keyword">auto</span> opposing_proc_creds = unstructured_master_channel.<a class="code hl_function" href="classipc_1_1transport_1_1Socket__stream__channel.html#acad7936d9a7db817bc46ee4fe479d838">remote_peer_process_credentials</a>(&amp;err_code);</div>
<div class="line"><a id="l01663" name="l01663"></a><span class="lineno"> 1663</span>      assert((!err_code) &amp;&amp; <span class="stringliteral">&quot;It really should not fail that early.  If it does look into this code.&quot;</span>);</div>
<div class="line"><a id="l01664" name="l01664"></a><span class="lineno"> 1664</span>      FLOW_LOG_INFO(<span class="stringliteral">&quot;Server session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Opposing process info: [&quot;</span> &lt;&lt; opposing_proc_creds &lt;&lt; <span class="stringliteral">&quot;].&quot;</span>);</div>
<div class="line"><a id="l01665" name="l01665"></a><span class="lineno"> 1665</span>    }</div>
<div class="line"><a id="l01666" name="l01666"></a><span class="lineno"> 1666</span>    <span class="comment">// ...sock_stm is now hosed.  We have the Channel.</span></div>
<div class="line"><a id="l01667" name="l01667"></a><span class="lineno"> 1667</span> </div>
<div class="line"><a id="l01668" name="l01668"></a><span class="lineno"> 1668</span>    <span class="comment">/* Finally: eat the Channel; make it live inside m_master_channel.  This session master channel requires</span></div>
<div class="line"><a id="l01669" name="l01669"></a><span class="lineno"> 1669</span><span class="comment">     * a log-in phase (the only such channel in the session), so use that ctor. */</span></div>
<div class="line"><a id="l01670" name="l01670"></a><span class="lineno"> 1670</span>    assert(!m_master_channel);</div>
<div class="line"><a id="l01671" name="l01671"></a><span class="lineno"> 1671</span>    m_master_channel = make_shared&lt;Master_structured_channel&gt;(get_logger(), std::move(unstructured_master_channel),</div>
<div class="line"><a id="l01672" name="l01672"></a><span class="lineno"> 1672</span>                                                              <a class="code hl_variable" href="classipc_1_1transport_1_1struc_1_1Channel__base.html#ab0eb05b5fb52364c99868a8535aaf26e">transport::struc::Channel_base::S_SERIALIZE_VIA_HEAP</a>,</div>
<div class="line"><a id="l01673" name="l01673"></a><span class="lineno"> 1673</span>                                                              <span class="keyword">true</span>); <span class="comment">// We are the server, not the client.</span></div>
<div class="line"><a id="l01674" name="l01674"></a><span class="lineno"> 1674</span>    <span class="comment">// unstructured_master_channel is now hosed.</span></div>
<div class="line"><a id="l01675" name="l01675"></a><span class="lineno"> 1675</span> </div>
<div class="line"><a id="l01676" name="l01676"></a><span class="lineno"> 1676</span>    <span class="comment">/* Enable liveness checking and keep-alive; the other side will do the same.</span></div>
<div class="line"><a id="l01677" name="l01677"></a><span class="lineno"> 1677</span><span class="comment">     * Per auto_ping() and idle_timer_run() concept docs, one uses *just* the latter only if the protocol is such</span></div>
<div class="line"><a id="l01678" name="l01678"></a><span class="lineno"> 1678</span><span class="comment">     * that our own application-layer messages are known to be sent at least at certain intervals.  Our protocol</span></div>
<div class="line"><a id="l01679" name="l01679"></a><span class="lineno"> 1679</span><span class="comment">     * is not that way, so per those docs use auto_ping() to periodically declare liveness.  Thus we use this</span></div>
<div class="line"><a id="l01680" name="l01680"></a><span class="lineno"> 1680</span><span class="comment">     * mechanism (in both directions) to detect unspecified zombie/death situations of the unstructured transport</span></div>
<div class="line"><a id="l01681" name="l01681"></a><span class="lineno"> 1681</span><span class="comment">     * layer.  E.g., if the other side is too dead to send pings or anything else, we will know and hopefully</span></div>
<div class="line"><a id="l01682" name="l01682"></a><span class="lineno"> 1682</span><span class="comment">     * shut the session down before things go really bad. */</span></div>
<div class="line"><a id="l01683" name="l01683"></a><span class="lineno"> 1683</span>    m_master_channel-&gt;owned_channel_mutable()-&gt;auto_ping();</div>
<div class="line"><a id="l01684" name="l01684"></a><span class="lineno"> 1684</span>    m_master_channel-&gt;owned_channel_mutable()-&gt;idle_timer_run();</div>
<div class="line"><a id="l01685" name="l01685"></a><span class="lineno"> 1685</span> </div>
<div class="line"><a id="l01686" name="l01686"></a><span class="lineno"> 1686</span>    m_master_channel-&gt;start([<span class="keyword">this</span>](<span class="keyword">const</span> <a class="code hl_typedef" href="namespaceipc.html#aa3192e586cc45d3e7c22463bf2760f89">Error_code</a>&amp; channel_err_code)</div>
<div class="line"><a id="l01687" name="l01687"></a><span class="lineno"> 1687</span>    {</div>
<div class="line"><a id="l01688" name="l01688"></a><span class="lineno"> 1688</span>      <span class="comment">// We are in thread Wc (unspecified, really struc::Channel async callback thread).</span></div>
<div class="line"><a id="l01689" name="l01689"></a><span class="lineno"> 1689</span>      m_async_worker.post([<span class="keyword">this</span>, channel_err_code]() { on_master_channel_error(channel_err_code); });</div>
<div class="line"><a id="l01690" name="l01690"></a><span class="lineno"> 1690</span>    });</div>
<div class="line"><a id="l01691" name="l01691"></a><span class="lineno"> 1691</span> </div>
<div class="line"><a id="l01692" name="l01692"></a><span class="lineno"> 1692</span>    <span class="comment">/* Let&#39;s overview our task as the session-opening server.  We do the other side of what Client_session_impl does</span></div>
<div class="line"><a id="l01693" name="l01693"></a><span class="lineno"> 1693</span><span class="comment">     * in it async_connect() flow, but we have one fewer phase: we already have the connected Native_socket_stream</span></div>
<div class="line"><a id="l01694" name="l01694"></a><span class="lineno"> 1694</span><span class="comment">     * and even have subsumed it in a Channel and even have subsumed *that* in a struc::Channel already.</span></div>
<div class="line"><a id="l01695" name="l01695"></a><span class="lineno"> 1695</span><span class="comment">     * So we just need to do the server side of the log-in.  It may help to follow along that part of the code</span></div>
<div class="line"><a id="l01696" name="l01696"></a><span class="lineno"> 1696</span><span class="comment">     * in Client_session.</span></div>
<div class="line"><a id="l01697" name="l01697"></a><span class="lineno"> 1697</span><span class="comment">     *</span></div>
<div class="line"><a id="l01698" name="l01698"></a><span class="lineno"> 1698</span><span class="comment">     * OK!  m_master_channel is rocking... but in the log-in phase (as server).  Follow the quite-rigid steps</span></div>
<div class="line"><a id="l01699" name="l01699"></a><span class="lineno"> 1699</span><span class="comment">     * documented for that phase namely: expect the log-in request message and respond with log-in response</span></div>
<div class="line"><a id="l01700" name="l01700"></a><span class="lineno"> 1700</span><span class="comment">     * message (first checking validity of various stuff in the former).  So this is the</span></div>
<div class="line"><a id="l01701" name="l01701"></a><span class="lineno"> 1701</span><span class="comment">     * async step (we must await the response).  It should be quite quick, as the client is doing its half of</span></div>
<div class="line"><a id="l01702" name="l01702"></a><span class="lineno"> 1702</span><span class="comment">     * the algorithm right now, but I digress. */</span></div>
<div class="line"><a id="l01703" name="l01703"></a><span class="lineno"> 1703</span>    <span class="keyword">const</span> <span class="keywordtype">bool</span> result = m_master_channel-&gt;expect_log_in_request</div>
<div class="line"><a id="l01704" name="l01704"></a><span class="lineno"> 1704</span>                          (Master_structured_channel::Msg_which_in::LOG_IN_REQ,</div>
<div class="line"><a id="l01705" name="l01705"></a><span class="lineno"> 1705</span>                           [<span class="keyword">this</span>, os_proc_creds, os_proc_invoked_as = std::move(os_proc_invoked_as),</div>
<div class="line"><a id="l01706" name="l01706"></a><span class="lineno"> 1706</span>                            init_channels_by_srv_req, mdt_from_cli_or_null, init_channels_by_cli_req,</div>
<div class="line"><a id="l01707" name="l01707"></a><span class="lineno"> 1707</span>                            cli_app_lookup_func = std::move(cli_app_lookup_func),</div>
<div class="line"><a id="l01708" name="l01708"></a><span class="lineno"> 1708</span>                            cli_namespace_func = std::move(cli_namespace_func),</div>
<div class="line"><a id="l01709" name="l01709"></a><span class="lineno"> 1709</span>                            pre_rsp_setup_func = std::move(pre_rsp_setup_func),</div>
<div class="line"><a id="l01710" name="l01710"></a><span class="lineno"> 1710</span>                            n_init_channels_by_srv_req_func = std::move(n_init_channels_by_srv_req_func),</div>
<div class="line"><a id="l01711" name="l01711"></a><span class="lineno"> 1711</span>                            mdt_load_func = std::move(mdt_load_func)]</div>
<div class="line"><a id="l01712" name="l01712"></a><span class="lineno"> 1712</span>                             (<span class="keyword">typename</span> Master_structured_channel::Msg_in_ptr&amp;&amp; log_in_req) <span class="keyword">mutable</span></div>
<div class="line"><a id="l01713" name="l01713"></a><span class="lineno"> 1713</span>    {</div>
<div class="line"><a id="l01714" name="l01714"></a><span class="lineno"> 1714</span>      <span class="comment">// We are in thread Wc (unspecified, really struc::Channel async callback thread).</span></div>
<div class="line"><a id="l01715" name="l01715"></a><span class="lineno"> 1715</span>      m_async_worker.post([<span class="keyword">this</span>, os_proc_creds, os_proc_invoked_as = std::move(os_proc_invoked_as),</div>
<div class="line"><a id="l01716" name="l01716"></a><span class="lineno"> 1716</span>                           log_in_req = std::move(log_in_req),</div>
<div class="line"><a id="l01717" name="l01717"></a><span class="lineno"> 1717</span>                           init_channels_by_srv_req, mdt_from_cli_or_null, init_channels_by_cli_req,</div>
<div class="line"><a id="l01718" name="l01718"></a><span class="lineno"> 1718</span>                           cli_app_lookup_func = std::move(cli_app_lookup_func),</div>
<div class="line"><a id="l01719" name="l01719"></a><span class="lineno"> 1719</span>                           cli_namespace_func = std::move(cli_namespace_func),</div>
<div class="line"><a id="l01720" name="l01720"></a><span class="lineno"> 1720</span>                           pre_rsp_setup_func = std::move(pre_rsp_setup_func),</div>
<div class="line"><a id="l01721" name="l01721"></a><span class="lineno"> 1721</span>                           n_init_channels_by_srv_req_func = std::move(n_init_channels_by_srv_req_func),</div>
<div class="line"><a id="l01722" name="l01722"></a><span class="lineno"> 1722</span>                           mdt_load_func = std::move(mdt_load_func)]()</div>
<div class="line"><a id="l01723" name="l01723"></a><span class="lineno"> 1723</span>      {</div>
<div class="line"><a id="l01724" name="l01724"></a><span class="lineno"> 1724</span>        <span class="comment">// We are in thread W.</span></div>
<div class="line"><a id="l01725" name="l01725"></a><span class="lineno"> 1725</span> </div>
<div class="line"><a id="l01726" name="l01726"></a><span class="lineno"> 1726</span>        assert(m_master_channel</div>
<div class="line"><a id="l01727" name="l01727"></a><span class="lineno"> 1727</span>               &amp;&amp; <span class="stringliteral">&quot;We should not get invoked, if on_master_channel_error() was invoked, and &quot;</span></div>
<div class="line"><a id="l01728" name="l01728"></a><span class="lineno"> 1728</span>                    <span class="stringliteral">&quot;the latter should be the only way to nuke m_master_channel at this stage.&quot;</span>);</div>
<div class="line"><a id="l01729" name="l01729"></a><span class="lineno"> 1729</span> </div>
<div class="line"><a id="l01730" name="l01730"></a><span class="lineno"> 1730</span>        <a class="code hl_typedef" href="namespaceipc.html#aa3192e586cc45d3e7c22463bf2760f89">Error_code</a> err_code; <span class="comment">// A few things can go wrong below; start with success assumption.</span></div>
<div class="line"><a id="l01731" name="l01731"></a><span class="lineno"> 1731</span> </div>
<div class="line"><a id="l01732" name="l01732"></a><span class="lineno"> 1732</span>        <span class="keyword">const</span> <span class="keyword">auto</span> msg_root = log_in_req-&gt;body_root().getLogInReq();</div>
<div class="line"><a id="l01733" name="l01733"></a><span class="lineno"> 1733</span>        <span class="comment">// (Initialize to avoid -- incorrect -- warning.)</span></div>
<div class="line"><a id="l01734" name="l01734"></a><span class="lineno"> 1734</span>        <span class="keywordtype">size_t</span> n_init_channels = 0; <span class="comment">// If successful log-in (so far) set this to how many init channels we&#39;ll open.</span></div>
<div class="line"><a id="l01735" name="l01735"></a><span class="lineno"> 1735</span>        <span class="keywordtype">size_t</span> n_init_channels_by_cli_req = 0;</div>
<div class="line"><a id="l01736" name="l01736"></a><span class="lineno"> 1736</span>        <a class="code hl_typedef" href="classipc_1_1session_1_1Server__session__impl.html#a78e61f8681c7ec92fa19bae560763ab1">Mdt_reader_ptr</a> mdt_from_cli; <span class="comment">// If successful log-in (so far) set this to eventual *mdt_from_cli_or_null result.</span></div>
<div class="line"><a id="l01737" name="l01737"></a><span class="lineno"> 1737</span> </div>
<div class="line"><a id="l01738" name="l01738"></a><span class="lineno"> 1738</span>        <span class="comment">/* Please see &quot;Protocol negotiation&quot; in Client_session_impl class doc header for discussion; and notes in the</span></div>
<div class="line"><a id="l01739" name="l01739"></a><span class="lineno"> 1739</span><span class="comment">         * schema .capnp file around ProtocolNegotiation-typed fields.</span></div>
<div class="line"><a id="l01740" name="l01740"></a><span class="lineno"> 1740</span><span class="comment">         *</span></div>
<div class="line"><a id="l01741" name="l01741"></a><span class="lineno"> 1741</span><span class="comment">         * Protocol-negotiation occurs *here*, before any further fields are interpreted. */</span></div>
<div class="line"><a id="l01742" name="l01742"></a><span class="lineno"> 1742</span>        <span class="keyword">const</span> <span class="keyword">auto</span> proto_neg_root = msg_root.getProtocolNegotiationToServer();</div>
<div class="line"><a id="l01743" name="l01743"></a><span class="lineno"> 1743</span>        m_protocol_negotiator.compute_negotiated_proto_ver(proto_neg_root.getMaxProtoVer(), &amp;err_code);</div>
<div class="line"><a id="l01744" name="l01744"></a><span class="lineno"> 1744</span>        <span class="keywordflow">if</span> (!err_code)</div>
<div class="line"><a id="l01745" name="l01745"></a><span class="lineno"> 1745</span>        {</div>
<div class="line"><a id="l01746" name="l01746"></a><span class="lineno"> 1746</span>          m_protocol_negotiator_aux.compute_negotiated_proto_ver(proto_neg_root.getMaxProtoVerAux(), &amp;err_code);</div>
<div class="line"><a id="l01747" name="l01747"></a><span class="lineno"> 1747</span>          <span class="keywordflow">if</span> (!err_code)</div>
<div class="line"><a id="l01748" name="l01748"></a><span class="lineno"> 1748</span>          {</div>
<div class="line"><a id="l01749" name="l01749"></a><span class="lineno"> 1749</span>            <span class="comment">/* As of this writing there is only protocol version 1.  In the future, if we add more versions *and*</span></div>
<div class="line"><a id="l01750" name="l01750"></a><span class="lineno"> 1750</span><span class="comment">             * decide to be backwards-compatible with older versions, then this is the point from which one knows</span></div>
<div class="line"><a id="l01751" name="l01751"></a><span class="lineno"> 1751</span><span class="comment">             * which protocol-version to speak (query m_protocol_negotiator.negotiated_proto_ver(); other Session</span></div>
<div class="line"><a id="l01752" name="l01752"></a><span class="lineno"> 1752</span><span class="comment">             * hierarchies can query m_protocol_negotiator_aux.&lt;same&gt;()). */</span></div>
<div class="line"><a id="l01753" name="l01753"></a><span class="lineno"> 1753</span> </div>
<div class="line"><a id="l01754" name="l01754"></a><span class="lineno"> 1754</span>            <span class="keywordflow">if</span> ((msg_root.getShmTypeOrNone() != S_SHM_TYPE)</div>
<div class="line"><a id="l01755" name="l01755"></a><span class="lineno"> 1755</span>                || (msg_root.getMqTypeOrNone() != S_MQ_TYPE_OR_NONE)</div>
<div class="line"><a id="l01756" name="l01756"></a><span class="lineno"> 1756</span>                || (msg_root.getNativeHandleTransmissionEnabled() != S_TRANSMIT_NATIVE_HANDLES))</div>
<div class="line"><a id="l01757" name="l01757"></a><span class="lineno"> 1757</span>            {</div>
<div class="line"><a id="l01758" name="l01758"></a><span class="lineno"> 1758</span>              FLOW_LOG_WARNING(<span class="stringliteral">&quot;Server session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Accept-log-in: Log-in request received; &quot;</span></div>
<div class="line"><a id="l01759" name="l01759"></a><span class="lineno"> 1759</span>                               <span class="stringliteral">&quot;but client desired process SHM/channel config (SHM-type &quot;</span></div>
<div class="line"><a id="l01760" name="l01760"></a><span class="lineno"> 1760</span>                               <span class="stringliteral">&quot;[&quot;</span> &lt;&lt; <span class="keywordtype">int</span>(msg_root.getShmTypeOrNone()) &lt;&lt; <span class="stringliteral">&quot;], MQ-type &quot;</span></div>
<div class="line"><a id="l01761" name="l01761"></a><span class="lineno"> 1761</span>                               <span class="stringliteral">&quot;[&quot;</span> &lt;&lt; <span class="keywordtype">int</span>(msg_root.getMqTypeOrNone()) &lt;&lt; <span class="stringliteral">&quot;], transmit-native-handles? = &quot;</span></div>
<div class="line"><a id="l01762" name="l01762"></a><span class="lineno"> 1762</span>                               <span class="stringliteral">&quot;[&quot;</span> &lt;&lt; msg_root.getNativeHandleTransmissionEnabled() &lt;&lt; <span class="stringliteral">&quot;]) &quot;</span></div>
<div class="line"><a id="l01763" name="l01763"></a><span class="lineno"> 1763</span>                               <span class="stringliteral">&quot;does not match our local config ([&quot;</span> &lt;&lt; <span class="keywordtype">int</span>(S_SHM_TYPE) &lt;&lt; <span class="charliteral">&#39;/&#39;</span></div>
<div class="line"><a id="l01764" name="l01764"></a><span class="lineno"> 1764</span>                               &lt;&lt; <span class="keywordtype">int</span>(S_MQ_TYPE_OR_NONE) &lt;&lt; <span class="charliteral">&#39;/&#39;</span> &lt;&lt; S_TRANSMIT_NATIVE_HANDLES &lt;&lt; <span class="stringliteral">&quot;]).  &quot;</span></div>
<div class="line"><a id="l01765" name="l01765"></a><span class="lineno"> 1765</span>                               <span class="stringliteral">&quot;Perhaps the other side used Client_session variant class not matching local &quot;</span></div>
<div class="line"><a id="l01766" name="l01766"></a><span class="lineno"> 1766</span>                               <span class="stringliteral">&quot;Server_session variant class and/or different template parameters.  &quot;</span></div>
<div class="line"><a id="l01767" name="l01767"></a><span class="lineno"> 1767</span>                               <span class="stringliteral">&quot;Closing session master channel and reporting to user via on-accept-log-in handler.&quot;</span>);</div>
<div class="line"><a id="l01768" name="l01768"></a><span class="lineno"> 1768</span>              err_code = <a class="code hl_enumvalue" href="namespaceipc_1_1session_1_1error.html#a0708d4bec9ae853f4d7e3d7822fc8f2fac734bd48bbfe30867f627363a8d5afc4">error::Code::S_SERVER_MASTER_LOG_IN_REQUEST_CONFIG_MISMATCH</a>;</div>
<div class="line"><a id="l01769" name="l01769"></a><span class="lineno"> 1769</span>            } <span class="comment">// if (msg_root.shmType, mqType, ... are not OK)</span></div>
<div class="line"><a id="l01770" name="l01770"></a><span class="lineno"> 1770</span>            <span class="keywordflow">else</span> <span class="comment">// if (msg_root.shmType, mqType, ... are OK)</span></div>
<div class="line"><a id="l01771" name="l01771"></a><span class="lineno"> 1771</span>            {</div>
<div class="line"><a id="l01772" name="l01772"></a><span class="lineno"> 1772</span>              n_init_channels_by_cli_req = msg_root.getNumInitChannelsByCliReq();</div>
<div class="line"><a id="l01773" name="l01773"></a><span class="lineno"> 1773</span>              <span class="keywordflow">if</span> ((n_init_channels_by_cli_req != 0) &amp;&amp; (!init_channels_by_cli_req))</div>
<div class="line"><a id="l01774" name="l01774"></a><span class="lineno"> 1774</span>              {</div>
<div class="line"><a id="l01775" name="l01775"></a><span class="lineno"> 1775</span>                FLOW_LOG_WARNING(<span class="stringliteral">&quot;Server session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Accept-log-in: Log-in request received; &quot;</span></div>
<div class="line"><a id="l01776" name="l01776"></a><span class="lineno"> 1776</span>                                 <span class="stringliteral">&quot;but this side passed null container for &quot;</span></div>
<div class="line"><a id="l01777" name="l01777"></a><span class="lineno"> 1777</span>                                 <span class="stringliteral">&quot;init-channels-by-cli-request, while client indicates it will open &quot;</span></div>
<div class="line"><a id="l01778" name="l01778"></a><span class="lineno"> 1778</span>                                 <span class="stringliteral">&quot;[&quot;</span> &lt;&lt; n_init_channels_by_cli_req &lt;&lt; <span class="stringliteral">&quot;] of them -- this or other side misbehaved?  &quot;</span></div>
<div class="line"><a id="l01779" name="l01779"></a><span class="lineno"> 1779</span>                                 <span class="stringliteral">&quot;Closing session master channel and reporting to user via on-accept-log-in handler.&quot;</span>);</div>
<div class="line"><a id="l01780" name="l01780"></a><span class="lineno"> 1780</span>                err_code = <a class="code hl_enumvalue" href="namespaceipc_1_1session_1_1error.html#a0708d4bec9ae853f4d7e3d7822fc8f2fac416e988563e44bf15fc6a81743eef53">error::Code::S_INVALID_ARGUMENT</a>;</div>
<div class="line"><a id="l01781" name="l01781"></a><span class="lineno"> 1781</span>              }</div>
<div class="line"><a id="l01782" name="l01782"></a><span class="lineno"> 1782</span>              <span class="keywordflow">else</span> <span class="comment">// if (n_init_channels_by_cli_req is OK)</span></div>
<div class="line"><a id="l01783" name="l01783"></a><span class="lineno"> 1783</span>              {</div>
<div class="line"><a id="l01784" name="l01784"></a><span class="lineno"> 1784</span>                <span class="comment">/* @todo We are assuming good-faith here about the message&#39;s contents; should probably be more paranoid</span></div>
<div class="line"><a id="l01785" name="l01785"></a><span class="lineno"> 1785</span><span class="comment">                 * for consistency regarding, like, a null claimed_own_proc_creds.  Change assert() to a real error</span></div>
<div class="line"><a id="l01786" name="l01786"></a><span class="lineno"> 1786</span><span class="comment">                 * maybe, etc. */</span></div>
<div class="line"><a id="l01787" name="l01787"></a><span class="lineno"> 1787</span>                assert(msg_root.hasClaimedOwnProcessCredentials());</div>
<div class="line"><a id="l01788" name="l01788"></a><span class="lineno"> 1788</span> </div>
<div class="line"><a id="l01789" name="l01789"></a><span class="lineno"> 1789</span>                <span class="keyword">auto</span> claimed_proc_creds_root = msg_root.getClaimedOwnProcessCredentials();</div>
<div class="line"><a id="l01790" name="l01790"></a><span class="lineno"> 1790</span>                <span class="keyword">const</span> Process_credentials claimed_proc_creds(claimed_proc_creds_root.getProcessId(),</div>
<div class="line"><a id="l01791" name="l01791"></a><span class="lineno"> 1791</span>                                                             claimed_proc_creds_root.getUserId(),</div>
<div class="line"><a id="l01792" name="l01792"></a><span class="lineno"> 1792</span>                                                             claimed_proc_creds_root.getGroupId());</div>
<div class="line"><a id="l01793" name="l01793"></a><span class="lineno"> 1793</span> </div>
<div class="line"><a id="l01794" name="l01794"></a><span class="lineno"> 1794</span>                <span class="keyword">const</span> <span class="keywordtype">string</span> cli_app_name(msg_root.getOwnApp().getName());</div>
<div class="line"><a id="l01795" name="l01795"></a><span class="lineno"> 1795</span>                <span class="keyword">const</span> <a class="code hl_struct" href="structipc_1_1session_1_1Client__app.html">Client_app</a>* <span class="keyword">const</span> cli_app_ptr_or_null = cli_app_lookup_func(cli_app_name);</div>
<div class="line"><a id="l01796" name="l01796"></a><span class="lineno"> 1796</span> </div>
<div class="line"><a id="l01797" name="l01797"></a><span class="lineno"> 1797</span>                <span class="keywordflow">if</span> ((!cli_app_ptr_or_null) ||</div>
<div class="line"><a id="l01798" name="l01798"></a><span class="lineno"> 1798</span>                    (!flow::util::key_exists(Base::m_srv_app_ref.m_allowed_client_apps, cli_app_name)))</div>
<div class="line"><a id="l01799" name="l01799"></a><span class="lineno"> 1799</span>                {</div>
<div class="line"><a id="l01800" name="l01800"></a><span class="lineno"> 1800</span>                  FLOW_LOG_WARNING(<span class="stringliteral">&quot;Server session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Accept-log-in: Log-in request received (claimed &quot;</span></div>
<div class="line"><a id="l01801" name="l01801"></a><span class="lineno"> 1801</span>                                   <span class="stringliteral">&quot;client process creds [&quot;</span> &lt;&lt; claimed_proc_creds &lt;&lt; <span class="stringliteral">&quot;], &quot;</span></div>
<div class="line"><a id="l01802" name="l01802"></a><span class="lineno"> 1802</span>                                   <span class="stringliteral">&quot;OS-reported client process creds [&quot;</span> &lt;&lt; os_proc_creds &lt;&lt; <span class="stringliteral">&quot;], &quot;</span></div>
<div class="line"><a id="l01803" name="l01803"></a><span class="lineno"> 1803</span>                                   <span class="stringliteral">&quot;OS-reported invoked-as name [&quot;</span> &lt;&lt; os_proc_invoked_as &lt;&lt; <span class="stringliteral">&quot;], &quot;</span></div>
<div class="line"><a id="l01804" name="l01804"></a><span class="lineno"> 1804</span>                                   <span class="stringliteral">&quot;cli-app-name [&quot;</span> &lt;&lt; cli_app_name &lt;&lt; <span class="stringliteral">&quot;]); but the latter is unknown or not in the &quot;</span></div>
<div class="line"><a id="l01805" name="l01805"></a><span class="lineno"> 1805</span>                                   <span class="stringliteral">&quot;allow-list for the present server-app [&quot;</span> &lt;&lt; Base::m_srv_app_ref &lt;&lt; <span class="stringliteral">&quot;].  &quot;</span></div>
<div class="line"><a id="l01806" name="l01806"></a><span class="lineno"> 1806</span>                                   <span class="stringliteral">&quot;Closing session master channel and reporting to user via on-accept-log-in &quot;</span></div>
<div class="line"><a id="l01807" name="l01807"></a><span class="lineno"> 1807</span>                                   <span class="stringliteral">&quot;handler.&quot;</span>);</div>
<div class="line"><a id="l01808" name="l01808"></a><span class="lineno"> 1808</span>                  err_code = <a class="code hl_enumvalue" href="namespaceipc_1_1session_1_1error.html#a0708d4bec9ae853f4d7e3d7822fc8f2faa195e468548ba9602c27590f2d6d49f0">error::Code::S_SERVER_MASTER_LOG_IN_REQUEST_CLIENT_APP_DISALLOWED_OR_UNKNOWN</a>;</div>
<div class="line"><a id="l01809" name="l01809"></a><span class="lineno"> 1809</span>                }</div>
<div class="line"><a id="l01810" name="l01810"></a><span class="lineno"> 1810</span>                <span class="keywordflow">else</span> <span class="comment">// if (cli_app_ptr_or_null)</span></div>
<div class="line"><a id="l01811" name="l01811"></a><span class="lineno"> 1811</span>                {</div>
<div class="line"><a id="l01812" name="l01812"></a><span class="lineno"> 1812</span>                  Base::set_cli_app_ptr(cli_app_ptr_or_null);</div>
<div class="line"><a id="l01813" name="l01813"></a><span class="lineno"> 1813</span> </div>
<div class="line"><a id="l01814" name="l01814"></a><span class="lineno"> 1814</span>                  <span class="comment">/* Nice, the other side&#39;s Client_app is valid and allowed.  Run safety checks on claimed_proc_creds;</span></div>
<div class="line"><a id="l01815" name="l01815"></a><span class="lineno"> 1815</span><span class="comment">                   * they must reconfirm the Client_app they mean is the Client_app we know by checking for consistency</span></div>
<div class="line"><a id="l01816" name="l01816"></a><span class="lineno"> 1816</span><span class="comment">                   * of the values against our Client_app config; plus ensure consistency by checking gainst the</span></div>
<div class="line"><a id="l01817" name="l01817"></a><span class="lineno"> 1817</span><span class="comment">                   * OS-reported values (in case it&#39;s some kind snafu or spoofing or who knows). */</span></div>
<div class="line"><a id="l01818" name="l01818"></a><span class="lineno"> 1818</span>                  <span class="keywordflow">if</span> ((claimed_proc_creds != os_proc_creds)</div>
<div class="line"><a id="l01819" name="l01819"></a><span class="lineno"> 1819</span>                      || (Base::cli_app_ptr()-&gt;m_exec_path.string() != os_proc_invoked_as)</div>
<div class="line"><a id="l01820" name="l01820"></a><span class="lineno"> 1820</span>                      || (Base::cli_app_ptr()-&gt;m_user_id != claimed_proc_creds.user_id())</div>
<div class="line"><a id="l01821" name="l01821"></a><span class="lineno"> 1821</span>                      || (Base::cli_app_ptr()-&gt;m_group_id != claimed_proc_creds.group_id()))</div>
<div class="line"><a id="l01822" name="l01822"></a><span class="lineno"> 1822</span>                  {</div>
<div class="line"><a id="l01823" name="l01823"></a><span class="lineno"> 1823</span>                    FLOW_LOG_WARNING(<span class="stringliteral">&quot;Server session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Accept-log-in: Log-in request received &quot;</span></div>
<div class="line"><a id="l01824" name="l01824"></a><span class="lineno"> 1824</span>                                     <span class="stringliteral">&quot;(claimed client process creds [&quot;</span> &lt;&lt; claimed_proc_creds &lt;&lt; <span class="stringliteral">&quot;], &quot;</span></div>
<div class="line"><a id="l01825" name="l01825"></a><span class="lineno"> 1825</span>                                     <span class="stringliteral">&quot;OS-reported client process creds [&quot;</span> &lt;&lt; os_proc_creds &lt;&lt; <span class="stringliteral">&quot;], &quot;</span></div>
<div class="line"><a id="l01826" name="l01826"></a><span class="lineno"> 1826</span>                                     <span class="stringliteral">&quot;OS-reported invoked-as name [&quot;</span> &lt;&lt; os_proc_invoked_as &lt;&lt; <span class="stringliteral">&quot;], &quot;</span></div>
<div class="line"><a id="l01827" name="l01827"></a><span class="lineno"> 1827</span>                                     <span class="stringliteral">&quot;client-app [&quot;</span> &lt;&lt; *(Base::cli_app_ptr()) &lt;&lt; <span class="stringliteral">&quot;]); and the latter is known and in &quot;</span></div>
<div class="line"><a id="l01828" name="l01828"></a><span class="lineno"> 1828</span>                                     <span class="stringliteral">&quot;allow-list for the present server-app [&quot;</span> &lt;&lt; Base::m_srv_app_ref &lt;&lt; <span class="stringliteral">&quot;].  &quot;</span></div>
<div class="line"><a id="l01829" name="l01829"></a><span class="lineno"> 1829</span>                                     <span class="stringliteral">&quot;However the aforementioned process creds (UID:GID) do not match &quot;</span></div>
<div class="line"><a id="l01830" name="l01830"></a><span class="lineno"> 1830</span>                                     <span class="stringliteral">&quot;the aforementioned locally-configured client-app values UID:GID; and/or &quot;</span></div>
<div class="line"><a id="l01831" name="l01831"></a><span class="lineno"> 1831</span>                                     <span class="stringliteral">&quot;the claimed creds (UID:GID, PID) do not match the OS-reported one from stream; &quot;</span></div>
<div class="line"><a id="l01832" name="l01832"></a><span class="lineno"> 1832</span>                                     <span class="stringliteral">&quot;and/or OS-reported invoked-as name does not *exactly* match client-app exec &quot;</span></div>
<div class="line"><a id="l01833" name="l01833"></a><span class="lineno"> 1833</span>                                     <span class="stringliteral">&quot;path.  For safety: Closing session master channel and reporting to user via &quot;</span></div>
<div class="line"><a id="l01834" name="l01834"></a><span class="lineno"> 1834</span>                                     <span class="stringliteral">&quot;on-accept-log-in handler.&quot;</span>);</div>
<div class="line"><a id="l01835" name="l01835"></a><span class="lineno"> 1835</span>                    err_code = <a class="code hl_enumvalue" href="namespaceipc_1_1session_1_1error.html#a0708d4bec9ae853f4d7e3d7822fc8f2fa3f305ed5a242f067c9116216c0674264">error::Code::S_SERVER_MASTER_LOG_IN_REQUEST_CLIENT_APP_INCONSISTENT_CREDS</a>;</div>
<div class="line"><a id="l01836" name="l01836"></a><span class="lineno"> 1836</span>                  }</div>
<div class="line"><a id="l01837" name="l01837"></a><span class="lineno"> 1837</span>                  <span class="keywordflow">else</span> <span class="comment">// if (creds are consistent)</span></div>
<div class="line"><a id="l01838" name="l01838"></a><span class="lineno"> 1838</span>                  {</div>
<div class="line"><a id="l01839" name="l01839"></a><span class="lineno"> 1839</span>                    <span class="comment">// Even nicer, Client_app is totally correct.  So we can do this to ~complete Session_base stuff.</span></div>
<div class="line"><a id="l01840" name="l01840"></a><span class="lineno"> 1840</span>                    Base::set_cli_namespace(cli_namespace_func());</div>
<div class="line"><a id="l01841" name="l01841"></a><span class="lineno"> 1841</span> </div>
<div class="line"><a id="l01842" name="l01842"></a><span class="lineno"> 1842</span>                    <span class="comment">// As promised run the setup thing just before sending the success response to opposing client.</span></div>
<div class="line"><a id="l01843" name="l01843"></a><span class="lineno"> 1843</span> </div>
<div class="line"><a id="l01844" name="l01844"></a><span class="lineno"> 1844</span>                    assert(!err_code);</div>
<div class="line"><a id="l01845" name="l01845"></a><span class="lineno"> 1845</span>                    <span class="keywordflow">if</span> ((err_code = pre_rsp_setup_func()))</div>
<div class="line"><a id="l01846" name="l01846"></a><span class="lineno"> 1846</span>                    {</div>
<div class="line"><a id="l01847" name="l01847"></a><span class="lineno"> 1847</span>                      FLOW_LOG_WARNING(<span class="stringliteral">&quot;Server session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Accept-log-in: Log-in request received &quot;</span></div>
<div class="line"><a id="l01848" name="l01848"></a><span class="lineno"> 1848</span>                                       <span class="stringliteral">&quot;(claimed client process creds [&quot;</span> &lt;&lt; claimed_proc_creds &lt;&lt; <span class="stringliteral">&quot;], &quot;</span></div>
<div class="line"><a id="l01849" name="l01849"></a><span class="lineno"> 1849</span>                                       <span class="stringliteral">&quot;OS-reported client process creds [&quot;</span> &lt;&lt; os_proc_creds &lt;&lt; <span class="stringliteral">&quot;], &quot;</span></div>
<div class="line"><a id="l01850" name="l01850"></a><span class="lineno"> 1850</span>                                       <span class="stringliteral">&quot;OS-reported invoked-as name [&quot;</span> &lt;&lt; os_proc_invoked_as &lt;&lt; <span class="stringliteral">&quot;], &quot;</span></div>
<div class="line"><a id="l01851" name="l01851"></a><span class="lineno"> 1851</span>                                       <span class="stringliteral">&quot;client-app [&quot;</span> &lt;&lt; *(Base::cli_app_ptr()) &lt;&lt; <span class="stringliteral">&quot;]); and the latter is known and in &quot;</span></div>
<div class="line"><a id="l01852" name="l01852"></a><span class="lineno"> 1852</span>                                       <span class="stringliteral">&quot;the allow-list for the present server-app [&quot;</span> &lt;&lt; Base::m_srv_app_ref &lt;&lt; <span class="stringliteral">&quot;].  &quot;</span></div>
<div class="line"><a id="l01853" name="l01853"></a><span class="lineno"> 1853</span>                                       <span class="stringliteral">&quot;Everything matches.  However the per-app setup code yielded error &quot;</span></div>
<div class="line"><a id="l01854" name="l01854"></a><span class="lineno"> 1854</span>                                       <span class="stringliteral">&quot;(details above).  Giving up; will not send log-in response.  &quot;</span></div>
<div class="line"><a id="l01855" name="l01855"></a><span class="lineno"> 1855</span>                                       <span class="stringliteral">&quot;Closing session master channel and reporting to user via &quot;</span></div>
<div class="line"><a id="l01856" name="l01856"></a><span class="lineno"> 1856</span>                                       <span class="stringliteral">&quot;on-accept-log-in handler.&quot;</span>);</div>
<div class="line"><a id="l01857" name="l01857"></a><span class="lineno"> 1857</span>                    }</div>
<div class="line"><a id="l01858" name="l01858"></a><span class="lineno"> 1858</span>                    <span class="keywordflow">else</span> <span class="comment">// if (!(err_code = pre_rsp_setup_func()))</span></div>
<div class="line"><a id="l01859" name="l01859"></a><span class="lineno"> 1859</span>                    {</div>
<div class="line"><a id="l01860" name="l01860"></a><span class="lineno"> 1860</span>                      <span class="comment">/* Cool then.  We can send the log-in response.  Now is a great time to 1, fish out the</span></div>
<div class="line"><a id="l01861" name="l01861"></a><span class="lineno"> 1861</span><span class="comment">                       * cli-&gt;srv metadata (to pass set out-arg to before successful user-handler execution);</span></div>
<div class="line"><a id="l01862" name="l01862"></a><span class="lineno"> 1862</span><span class="comment">                       * 2, ask local user (via in-arg function) how many channels it wants opened (they need</span></div>
<div class="line"><a id="l01863" name="l01863"></a><span class="lineno"> 1863</span><span class="comment">                       * various cli-&gt;srv info to make this decision); 3, compute srv-&gt;cli metadata</span></div>
<div class="line"><a id="l01864" name="l01864"></a><span class="lineno"> 1864</span><span class="comment">                       * (they need... ditto).  This stuff cannot fail. */</span></div>
<div class="line"><a id="l01865" name="l01865"></a><span class="lineno"> 1865</span> </div>
<div class="line"><a id="l01866" name="l01866"></a><span class="lineno"> 1866</span>                      <span class="comment">// Firstly: the cli-&gt;srv metadata.</span></div>
<div class="line"><a id="l01867" name="l01867"></a><span class="lineno"> 1867</span>                      <span class="keyword">const</span> <span class="keyword">auto</span> log_in_req_saved = log_in_req.get(); <span class="comment">// It&#39;ll get move()d away below; save it.</span></div>
<div class="line"><a id="l01868" name="l01868"></a><span class="lineno"> 1868</span>                      {</div>
<div class="line"><a id="l01869" name="l01869"></a><span class="lineno"> 1869</span>                        <span class="comment">/* Only set *mdt_from_cli_or_null when invoking handler on success as promised; untouched</span></div>
<div class="line"><a id="l01870" name="l01870"></a><span class="lineno"> 1870</span><span class="comment">                         * otherwise as promised.  Use the same technique as when emitting `mdt` in</span></div>
<div class="line"><a id="l01871" name="l01871"></a><span class="lineno"> 1871</span><span class="comment">                         * on_master_channel_open_channel_req(); omitting comments. */</span></div>
<div class="line"><a id="l01872" name="l01872"></a><span class="lineno"> 1872</span>                        <span class="keyword">struct </span>Req_and_mdt_reader</div>
<div class="line"><a id="l01873" name="l01873"></a><span class="lineno"> 1873</span>                        {</div>
<div class="line"><a id="l01874" name="l01874"></a><span class="lineno"> 1874</span>                          <span class="keyword">typename</span> Mdt_reader_ptr::element_type m_mdt_reader;</div>
<div class="line"><a id="l01875" name="l01875"></a><span class="lineno"> 1875</span>                          <span class="keyword">typename</span> Master_structured_channel::Msg_in_ptr m_req;</div>
<div class="line"><a id="l01876" name="l01876"></a><span class="lineno"> 1876</span>                        };</div>
<div class="line"><a id="l01877" name="l01877"></a><span class="lineno"> 1877</span>                        shared_ptr&lt;Req_and_mdt_reader&gt; req_and_mdt(<span class="keyword">new</span> Req_and_mdt_reader</div>
<div class="line"><a id="l01878" name="l01878"></a><span class="lineno"> 1878</span>                                                                         { msg_root.getMetadata(),</div>
<div class="line"><a id="l01879" name="l01879"></a><span class="lineno"> 1879</span>                                                                           std::move(log_in_req) });</div>
<div class="line"><a id="l01880" name="l01880"></a><span class="lineno"> 1880</span>                        <span class="comment">// (log_in_req is now hosed.)</span></div>
<div class="line"><a id="l01881" name="l01881"></a><span class="lineno"> 1881</span>                        mdt_from_cli = <a class="code hl_typedef" href="classipc_1_1session_1_1Server__session__impl.html#a78e61f8681c7ec92fa19bae560763ab1">Mdt_reader_ptr</a>(std::move(req_and_mdt), &amp;req_and_mdt-&gt;m_mdt_reader);</div>
<div class="line"><a id="l01882" name="l01882"></a><span class="lineno"> 1882</span>                      } <span class="comment">// {}</span></div>
<div class="line"><a id="l01883" name="l01883"></a><span class="lineno"> 1883</span> </div>
<div class="line"><a id="l01884" name="l01884"></a><span class="lineno"> 1884</span>                      <span class="comment">// Secondly: n_init_channels (we have n_init_channels_by_cli_req; now add the local count).</span></div>
<div class="line"><a id="l01885" name="l01885"></a><span class="lineno"> 1885</span>                      n_init_channels = n_init_channels_by_cli_req;</div>
<div class="line"><a id="l01886" name="l01886"></a><span class="lineno"> 1886</span>                      <span class="keywordflow">if</span> (init_channels_by_srv_req)</div>
<div class="line"><a id="l01887" name="l01887"></a><span class="lineno"> 1887</span>                      {</div>
<div class="line"><a id="l01888" name="l01888"></a><span class="lineno"> 1888</span>                        n_init_channels += n_init_channels_by_srv_req_func(*(Base::cli_app_ptr()),</div>
<div class="line"><a id="l01889" name="l01889"></a><span class="lineno"> 1889</span>                                                                           n_init_channels_by_cli_req,</div>
<div class="line"><a id="l01890" name="l01890"></a><span class="lineno"> 1890</span>                                                                           <a class="code hl_typedef" href="classipc_1_1session_1_1Server__session__impl.html#a78e61f8681c7ec92fa19bae560763ab1">Mdt_reader_ptr</a>(mdt_from_cli));</div>
<div class="line"><a id="l01891" name="l01891"></a><span class="lineno"> 1891</span>                      }</div>
<div class="line"><a id="l01892" name="l01892"></a><span class="lineno"> 1892</span> </div>
<div class="line"><a id="l01893" name="l01893"></a><span class="lineno"> 1893</span>                      <span class="comment">// Thirdly: srv-&gt;cli metadata.  This goes inside LogInRsp; so create that now.</span></div>
<div class="line"><a id="l01894" name="l01894"></a><span class="lineno"> 1894</span>                      <span class="keyword">auto</span> log_in_rsp_msg = m_master_channel-&gt;create_msg();</div>
<div class="line"><a id="l01895" name="l01895"></a><span class="lineno"> 1895</span>                      <span class="keyword">auto</span> log_in_rsp_root = log_in_rsp_msg.body_root()-&gt;initLogInRsp();</div>
<div class="line"><a id="l01896" name="l01896"></a><span class="lineno"> 1896</span>                      <span class="keyword">auto</span> mdt_from_srv_root = log_in_rsp_root.initMetadata();</div>
<div class="line"><a id="l01897" name="l01897"></a><span class="lineno"> 1897</span>                      <span class="comment">// And let them fill it out.</span></div>
<div class="line"><a id="l01898" name="l01898"></a><span class="lineno"> 1898</span>                      mdt_load_func(*(Base::cli_app_ptr()), n_init_channels_by_cli_req, <a class="code hl_typedef" href="classipc_1_1session_1_1Server__session__impl.html#a78e61f8681c7ec92fa19bae560763ab1">Mdt_reader_ptr</a>(mdt_from_cli),</div>
<div class="line"><a id="l01899" name="l01899"></a><span class="lineno"> 1899</span>                                    &amp;mdt_from_srv_root); <span class="comment">// They load this (if they want).</span></div>
<div class="line"><a id="l01900" name="l01900"></a><span class="lineno"> 1900</span> </div>
<div class="line"><a id="l01901" name="l01901"></a><span class="lineno"> 1901</span>                      <span class="comment">// Now we can send the log-in response finally.</span></div>
<div class="line"><a id="l01902" name="l01902"></a><span class="lineno"> 1902</span> </div>
<div class="line"><a id="l01903" name="l01903"></a><span class="lineno"> 1903</span>                      <span class="comment">// Similarly to Client_session_impl: give them our version info, so they can verify, as we did.</span></div>
<div class="line"><a id="l01904" name="l01904"></a><span class="lineno"> 1904</span>                      <span class="keyword">auto</span> proto_neg_root = log_in_rsp_root.initProtocolNegotiationToClient();</div>
<div class="line"><a id="l01905" name="l01905"></a><span class="lineno"> 1905</span>                      proto_neg_root.setMaxProtoVer(m_protocol_negotiator.local_max_proto_ver_for_sending());</div>
<div class="line"><a id="l01906" name="l01906"></a><span class="lineno"> 1906</span>                      proto_neg_root.setMaxProtoVerAux(m_protocol_negotiator_aux.local_max_proto_ver_for_sending());</div>
<div class="line"><a id="l01907" name="l01907"></a><span class="lineno"> 1907</span> </div>
<div class="line"><a id="l01908" name="l01908"></a><span class="lineno"> 1908</span>                      log_in_rsp_root.setClientNamespace(Base::cli_namespace().str());</div>
<div class="line"><a id="l01909" name="l01909"></a><span class="lineno"> 1909</span>                      log_in_rsp_root.setNumInitChannelsBySrvReq(n_init_channels - n_init_channels_by_cli_req);</div>
<div class="line"><a id="l01910" name="l01910"></a><span class="lineno"> 1910</span> </div>
<div class="line"><a id="l01911" name="l01911"></a><span class="lineno"> 1911</span>                      assert(!err_code);</div>
<div class="line"><a id="l01912" name="l01912"></a><span class="lineno"> 1912</span>                      <span class="keywordflow">if</span> (!m_master_channel-&gt;send(log_in_rsp_msg, log_in_req_saved, &amp;err_code))</div>
<div class="line"><a id="l01913" name="l01913"></a><span class="lineno"> 1913</span>                      {</div>
<div class="line"><a id="l01914" name="l01914"></a><span class="lineno"> 1914</span>                        <span class="comment">/* The docs say send() returns false if:</span></div>
<div class="line"><a id="l01915" name="l01915"></a><span class="lineno"> 1915</span><span class="comment">                         * &quot;`msg` with-handle, but #Owner_channel has no handles pipe; an #Error_code was previously</span></div>
<div class="line"><a id="l01916" name="l01916"></a><span class="lineno"> 1916</span><span class="comment">                         * emitted via on-error handler; async_end_sending() has already been called.&quot;  Only the middle</span></div>
<div class="line"><a id="l01917" name="l01917"></a><span class="lineno"> 1917</span><span class="comment">                         * one is possible in our case.  on_master_channel_error() shall issue</span></div>
<div class="line"><a id="l01918" name="l01918"></a><span class="lineno"> 1918</span><span class="comment">                         * m_log_in_on_done_func(truthy) in our stead. */</span></div>
<div class="line"><a id="l01919" name="l01919"></a><span class="lineno"> 1919</span>                        FLOW_LOG_TRACE(<span class="stringliteral">&quot;send() synchronously failed; must be an error situation.  Error handler should &quot;</span></div>
<div class="line"><a id="l01920" name="l01920"></a><span class="lineno"> 1920</span>                                       <span class="stringliteral">&quot;catch it shortly or has already caught it.&quot;</span>);</div>
<div class="line"><a id="l01921" name="l01921"></a><span class="lineno"> 1921</span>                        <span class="keywordflow">return</span>;</div>
<div class="line"><a id="l01922" name="l01922"></a><span class="lineno"> 1922</span>                      }</div>
<div class="line"><a id="l01923" name="l01923"></a><span class="lineno"> 1923</span>                      <span class="comment">// else either it succeeded (err_code still falsy); or it failed (truthy now).</span></div>
<div class="line"><a id="l01924" name="l01924"></a><span class="lineno"> 1924</span> </div>
<div class="line"><a id="l01925" name="l01925"></a><span class="lineno"> 1925</span>                      <span class="keywordflow">if</span> (err_code)</div>
<div class="line"><a id="l01926" name="l01926"></a><span class="lineno"> 1926</span>                      {</div>
<div class="line"><a id="l01927" name="l01927"></a><span class="lineno"> 1927</span>                        FLOW_LOG_WARNING(<span class="stringliteral">&quot;Server session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Accept-log-in: Log-in request received &quot;</span></div>
<div class="line"><a id="l01928" name="l01928"></a><span class="lineno"> 1928</span>                                         <span class="stringliteral">&quot;(claimed client process creds [&quot;</span> &lt;&lt; claimed_proc_creds &lt;&lt; <span class="stringliteral">&quot;], &quot;</span></div>
<div class="line"><a id="l01929" name="l01929"></a><span class="lineno"> 1929</span>                                         <span class="stringliteral">&quot;OS-reported client process creds [&quot;</span> &lt;&lt; os_proc_creds &lt;&lt; <span class="stringliteral">&quot;], &quot;</span></div>
<div class="line"><a id="l01930" name="l01930"></a><span class="lineno"> 1930</span>                                         <span class="stringliteral">&quot;OS-reported invoked-as name [&quot;</span> &lt;&lt; os_proc_invoked_as &lt;&lt; <span class="stringliteral">&quot;], &quot;</span></div>
<div class="line"><a id="l01931" name="l01931"></a><span class="lineno"> 1931</span>                                         <span class="stringliteral">&quot;client-app [&quot;</span> &lt;&lt; *(Base::cli_app_ptr()) &lt;&lt; <span class="stringliteral">&quot;]); and the latter is known and &quot;</span></div>
<div class="line"><a id="l01932" name="l01932"></a><span class="lineno"> 1932</span>                                         <span class="stringliteral">&quot;in allow-list for the present server-app [&quot;</span> &lt;&lt; Base::m_srv_app_ref &lt;&lt; <span class="stringliteral">&quot;].  &quot;</span></div>
<div class="line"><a id="l01933" name="l01933"></a><span class="lineno"> 1933</span>                                         <span class="stringliteral">&quot;Init-channel count expected is [&quot;</span> &lt;&lt; n_init_channels &lt;&lt; <span class="stringliteral">&quot;]; of these &quot;</span></div>
<div class="line"><a id="l01934" name="l01934"></a><span class="lineno"> 1934</span>                                         <span class="stringliteral">&quot;[&quot;</span> &lt;&lt; n_init_channels_by_cli_req &lt;&lt; <span class="stringliteral">&quot;] requested by opposing client.  &quot;</span></div>
<div class="line"><a id="l01935" name="l01935"></a><span class="lineno"> 1935</span>                                         <span class="stringliteral">&quot;Everything matches.  &quot;</span></div>
<div class="line"><a id="l01936" name="l01936"></a><span class="lineno"> 1936</span>                                         <span class="stringliteral">&quot;Log-in response (including saved cli-namespace &quot;</span></div>
<div class="line"><a id="l01937" name="l01937"></a><span class="lineno"> 1937</span>                                         <span class="stringliteral">&quot;[&quot;</span> &lt;&lt; Base::cli_namespace() &lt;&lt; <span class="stringliteral">&quot;] and filled-out srv-&gt;cli metadata) &quot;</span></div>
<div class="line"><a id="l01938" name="l01938"></a><span class="lineno"> 1938</span>                                         <span class="stringliteral">&quot;send attempted, but the send failed (details above).  &quot;</span></div>
<div class="line"><a id="l01939" name="l01939"></a><span class="lineno"> 1939</span>                                         <span class="stringliteral">&quot;Closing session master channel and reporting to user via &quot;</span></div>
<div class="line"><a id="l01940" name="l01940"></a><span class="lineno"> 1940</span>                                         <span class="stringliteral">&quot;on-accept-log-in handler.&quot;</span>);</div>
<div class="line"><a id="l01941" name="l01941"></a><span class="lineno"> 1941</span>                      }</div>
<div class="line"><a id="l01942" name="l01942"></a><span class="lineno"> 1942</span>                      <span class="keywordflow">else</span> <span class="comment">// if (!err_code)</span></div>
<div class="line"><a id="l01943" name="l01943"></a><span class="lineno"> 1943</span>                      {</div>
<div class="line"><a id="l01944" name="l01944"></a><span class="lineno"> 1944</span>                        <span class="comment">// Excellent.  m_master_channel auto-proceeds to logged-in phase on successful send().</span></div>
<div class="line"><a id="l01945" name="l01945"></a><span class="lineno"> 1945</span>                        FLOW_LOG_INFO(<span class="stringliteral">&quot;Server session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Accept-log-in: Log-in request received &quot;</span></div>
<div class="line"><a id="l01946" name="l01946"></a><span class="lineno"> 1946</span>                                      <span class="stringliteral">&quot;(claimed client process creds [&quot;</span> &lt;&lt; claimed_proc_creds &lt;&lt; <span class="stringliteral">&quot;], &quot;</span></div>
<div class="line"><a id="l01947" name="l01947"></a><span class="lineno"> 1947</span>                                      <span class="stringliteral">&quot;OS-reported client process creds [&quot;</span> &lt;&lt; os_proc_creds &lt;&lt; <span class="stringliteral">&quot;], &quot;</span></div>
<div class="line"><a id="l01948" name="l01948"></a><span class="lineno"> 1948</span>                                      <span class="stringliteral">&quot;OS-reported invoked-as name [&quot;</span> &lt;&lt; os_proc_invoked_as &lt;&lt; <span class="stringliteral">&quot;], &quot;</span></div>
<div class="line"><a id="l01949" name="l01949"></a><span class="lineno"> 1949</span>                                      <span class="stringliteral">&quot;client-app [&quot;</span> &lt;&lt; *(Base::cli_app_ptr()) &lt;&lt; <span class="stringliteral">&quot;]); and the latter is known and in &quot;</span></div>
<div class="line"><a id="l01950" name="l01950"></a><span class="lineno"> 1950</span>                                      <span class="stringliteral">&quot;allow-list for the present server-app [&quot;</span> &lt;&lt; Base::m_srv_app_ref &lt;&lt; <span class="stringliteral">&quot;].  &quot;</span></div>
<div class="line"><a id="l01951" name="l01951"></a><span class="lineno"> 1951</span>                                      <span class="stringliteral">&quot;Everything matches.  &quot;</span></div>
<div class="line"><a id="l01952" name="l01952"></a><span class="lineno"> 1952</span>                                      <span class="stringliteral">&quot;Log-in response, including saved cli-namespace &quot;</span></div>
<div class="line"><a id="l01953" name="l01953"></a><span class="lineno"> 1953</span>                                      <span class="stringliteral">&quot;[&quot;</span> &lt;&lt; Base ::cli_namespace() &lt;&lt; <span class="stringliteral">&quot;], sent OK.  &quot;</span></div>
<div class="line"><a id="l01954" name="l01954"></a><span class="lineno"> 1954</span>                                      <span class="stringliteral">&quot;Init-channel count expected is [&quot;</span> &lt;&lt; n_init_channels &lt;&lt; <span class="stringliteral">&quot;]; of these &quot;</span></div>
<div class="line"><a id="l01955" name="l01955"></a><span class="lineno"> 1955</span>                                      <span class="stringliteral">&quot;[&quot;</span> &lt;&lt; n_init_channels_by_cli_req &lt;&lt; <span class="stringliteral">&quot;] requested by opposing client.  &quot;</span></div>
<div class="line"><a id="l01956" name="l01956"></a><span class="lineno"> 1956</span>                                      <span class="stringliteral">&quot;If 0: Will go to almost-PEER state and report to user via on-accept-log-in &quot;</span></div>
<div class="line"><a id="l01957" name="l01957"></a><span class="lineno"> 1957</span>                                      <span class="stringliteral">&quot;handler (user must then invoke init_handlers() on the Server_session to reach &quot;</span></div>
<div class="line"><a id="l01958" name="l01958"></a><span class="lineno"> 1958</span>                                      <span class="stringliteral">&quot;PEER state).  &quot;</span></div>
<div class="line"><a id="l01959" name="l01959"></a><span class="lineno"> 1959</span>                                      <span class="stringliteral">&quot;Else: Will send that many open-channel-to-client requests with the init-channel &quot;</span></div>
<div class="line"><a id="l01960" name="l01960"></a><span class="lineno"> 1960</span>                                      <span class="stringliteral">&quot;info; and await one ack in return.&quot;</span>);</div>
<div class="line"><a id="l01961" name="l01961"></a><span class="lineno"> 1961</span>                      } <span class="comment">// else if (!err_code from send())</span></div>
<div class="line"><a id="l01962" name="l01962"></a><span class="lineno"> 1962</span>                    } <span class="comment">// else if (!(err_code = pre_rsp_setup_func())) (err_code might have become truthy inside though)</span></div>
<div class="line"><a id="l01963" name="l01963"></a><span class="lineno"> 1963</span>                  } <span class="comment">// else if (creds are consistent) (ditto re. err_code)</span></div>
<div class="line"><a id="l01964" name="l01964"></a><span class="lineno"> 1964</span>                } <span class="comment">// else if (cli_app_ptr_or_null) (ditto re. err_code)</span></div>
<div class="line"><a id="l01965" name="l01965"></a><span class="lineno"> 1965</span>              } <span class="comment">// else if (n_init_channels_by_cli_req is OK) (ditto re. err_code)</span></div>
<div class="line"><a id="l01966" name="l01966"></a><span class="lineno"> 1966</span>            } <span class="comment">// else if (msg_root.getShmTypeOrNone() == S_SHM_TYPE_OR_NONE) (ditto re. err_code)</span></div>
<div class="line"><a id="l01967" name="l01967"></a><span class="lineno"> 1967</span>          } <span class="comment">// else if (!err_code from m_protocol_negotiator_aux.compute_negotiated_proto_ver()) (ditto re. err_code)</span></div>
<div class="line"><a id="l01968" name="l01968"></a><span class="lineno"> 1968</span>        } <span class="comment">// else if (!err_code from m_protocol_negotiator.compute_negotiated_proto_ver()) (ditto re. err_code)</span></div>
<div class="line"><a id="l01969" name="l01969"></a><span class="lineno"> 1969</span> </div>
<div class="line"><a id="l01970" name="l01970"></a><span class="lineno"> 1970</span>        <span class="comment">// Whew.  OK then.  Did we pass the gauntlet?</span></div>
<div class="line"><a id="l01971" name="l01971"></a><span class="lineno"> 1971</span> </div>
<div class="line"><a id="l01972" name="l01972"></a><span class="lineno"> 1972</span>        <span class="keywordflow">if</span> (err_code)</div>
<div class="line"><a id="l01973" name="l01973"></a><span class="lineno"> 1973</span>        {</div>
<div class="line"><a id="l01974" name="l01974"></a><span class="lineno"> 1974</span>          <span class="comment">// As promised in the various error paths above: error =&gt; end the short-lived master channel.</span></div>
<div class="line"><a id="l01975" name="l01975"></a><span class="lineno"> 1975</span>          m_master_channel.reset();</div>
<div class="line"><a id="l01976" name="l01976"></a><span class="lineno"> 1976</span>        }</div>
<div class="line"><a id="l01977" name="l01977"></a><span class="lineno"> 1977</span>        <span class="comment">// As noted in the message just-logged (whether error or not):</span></div>
<div class="line"><a id="l01978" name="l01978"></a><span class="lineno"> 1978</span>        <span class="keywordflow">if</span> (err_code || (n_init_channels == 0))</div>
<div class="line"><a id="l01979" name="l01979"></a><span class="lineno"> 1979</span>        {</div>
<div class="line"><a id="l01980" name="l01980"></a><span class="lineno"> 1980</span>          <span class="keywordflow">if</span> ((!err_code) &amp;&amp; mdt_from_cli_or_null)</div>
<div class="line"><a id="l01981" name="l01981"></a><span class="lineno"> 1981</span>          {</div>
<div class="line"><a id="l01982" name="l01982"></a><span class="lineno"> 1982</span>            <span class="comment">// This out-arg still applies; n_init_channels being 0 is orthogonal!</span></div>
<div class="line"><a id="l01983" name="l01983"></a><span class="lineno"> 1983</span>            *mdt_from_cli_or_null = std::move(mdt_from_cli);</div>
<div class="line"><a id="l01984" name="l01984"></a><span class="lineno"> 1984</span>          }</div>
<div class="line"><a id="l01985" name="l01985"></a><span class="lineno"> 1985</span> </div>
<div class="line"><a id="l01986" name="l01986"></a><span class="lineno"> 1986</span>          m_log_in_on_done_func(err_code);</div>
<div class="line"><a id="l01987" name="l01987"></a><span class="lineno"> 1987</span>          FLOW_LOG_TRACE(<span class="stringliteral">&quot;Handler finished.&quot;</span>);</div>
<div class="line"><a id="l01988" name="l01988"></a><span class="lineno"> 1988</span>          m_log_in_on_done_func.clear();</div>
<div class="line"><a id="l01989" name="l01989"></a><span class="lineno"> 1989</span>          <span class="keywordflow">return</span>;</div>
<div class="line"><a id="l01990" name="l01990"></a><span class="lineno"> 1990</span>        }</div>
<div class="line"><a id="l01991" name="l01991"></a><span class="lineno"> 1991</span>        <span class="comment">// else if ((!err_code) &amp;&amp; (n_init_channels != 0)):</span></div>
<div class="line"><a id="l01992" name="l01992"></a><span class="lineno"> 1992</span> </div>
<div class="line"><a id="l01993" name="l01993"></a><span class="lineno"> 1993</span>        <a class="code hl_typedef" href="classipc_1_1session_1_1Server__session__impl.html#a75df7061f9c57660f9fb944d83da416b">Channels</a> init_channels; <span class="comment">// Put all init-channels here first.  Out-args touched only on ultimate success.</span></div>
<div class="line"><a id="l01994" name="l01994"></a><span class="lineno"> 1994</span>        init_channels.reserve(n_init_channels);</div>
<div class="line"><a id="l01995" name="l01995"></a><span class="lineno"> 1995</span>        <span class="keywordtype">bool</span> ok = <span class="keyword">true</span>;</div>
<div class="line"><a id="l01996" name="l01996"></a><span class="lineno"> 1996</span>        <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> idx = 0; (idx != n_init_channels) &amp;&amp; ok; ++idx)</div>
<div class="line"><a id="l01997" name="l01997"></a><span class="lineno"> 1997</span>        {</div>
<div class="line"><a id="l01998" name="l01998"></a><span class="lineno"> 1998</span>          init_channels.resize(idx + 1);</div>
<div class="line"><a id="l01999" name="l01999"></a><span class="lineno"> 1999</span>          <span class="keyword">auto</span>&amp; opened_channel = init_channels.back();</div>
<div class="line"><a id="l02000" name="l02000"></a><span class="lineno"> 2000</span>          <a class="code hl_struct" href="structipc_1_1util_1_1Native__handle.html">util::Native_handle</a> remote_hndl_or_null;</div>
<div class="line"><a id="l02001" name="l02001"></a><span class="lineno"> 2001</span>          <a class="code hl_class" href="classipc_1_1util_1_1Shared__name.html">Shared_name</a> mq_name_c2s_or_none;</div>
<div class="line"><a id="l02002" name="l02002"></a><span class="lineno"> 2002</span>          <a class="code hl_class" href="classipc_1_1util_1_1Shared__name.html">Shared_name</a> mq_name_s2c_or_none;</div>
<div class="line"><a id="l02003" name="l02003"></a><span class="lineno"> 2003</span> </div>
<div class="line"><a id="l02004" name="l02004"></a><span class="lineno"> 2004</span>          <span class="keywordflow">if</span> (!create_channel_and_resources(&amp;mq_name_c2s_or_none, &amp;mq_name_s2c_or_none, &amp;remote_hndl_or_null,</div>
<div class="line"><a id="l02005" name="l02005"></a><span class="lineno"> 2005</span>                                            &amp;opened_channel, <span class="keyword">true</span>)) <span class="comment">// true =&gt; active-open, not passive-open.</span></div>
<div class="line"><a id="l02006" name="l02006"></a><span class="lineno"> 2006</span>          {</div>
<div class="line"><a id="l02007" name="l02007"></a><span class="lineno"> 2007</span>            err_code = <a class="code hl_enumvalue" href="namespaceipc_1_1session_1_1error.html#a0708d4bec9ae853f4d7e3d7822fc8f2fa10d32cf1382fb003f09a6df2da408574">error::Code::S_SESSION_OPEN_CHANNEL_SERVER_CANNOT_PROCEED_RESOURCE_UNAVAILABLE</a>;</div>
<div class="line"><a id="l02008" name="l02008"></a><span class="lineno"> 2008</span>            ok = <span class="keyword">false</span>;</div>
<div class="line"><a id="l02009" name="l02009"></a><span class="lineno"> 2009</span>            <span class="keywordflow">continue</span>; <span class="comment">// Abort.</span></div>
<div class="line"><a id="l02010" name="l02010"></a><span class="lineno"> 2010</span>          }</div>
<div class="line"><a id="l02011" name="l02011"></a><span class="lineno"> 2011</span>          <span class="comment">// else</span></div>
<div class="line"><a id="l02012" name="l02012"></a><span class="lineno"> 2012</span>          <span class="keyword">auto</span> open_channel_req_msg = m_master_channel-&gt;create_msg(std::move(remote_hndl_or_null));</div>
<div class="line"><a id="l02013" name="l02013"></a><span class="lineno"> 2013</span>          <span class="keyword">auto</span> open_channel_root = open_channel_req_msg.body_root()-&gt;initOpenChannelToClientReq();</div>
<div class="line"><a id="l02014" name="l02014"></a><span class="lineno"> 2014</span>          open_channel_root.setClientToServerMqAbsNameOrEmpty(mq_name_c2s_or_none.<a class="code hl_function" href="classipc_1_1util_1_1Shared__name.html#ae89e1e061f87ffe0288514e254837595">str</a>());</div>
<div class="line"><a id="l02015" name="l02015"></a><span class="lineno"> 2015</span>          open_channel_root.setServerToClientMqAbsNameOrEmpty(mq_name_s2c_or_none.<a class="code hl_function" href="classipc_1_1util_1_1Shared__name.html#ae89e1e061f87ffe0288514e254837595">str</a>());</div>
<div class="line"><a id="l02016" name="l02016"></a><span class="lineno"> 2016</span> </div>
<div class="line"><a id="l02017" name="l02017"></a><span class="lineno"> 2017</span>          <span class="comment">/* Expect quick reply to the last one (we don&#39;t even check contents; it&#39;s just an ack, so</span></div>
<div class="line"><a id="l02018" name="l02018"></a><span class="lineno"> 2018</span><span class="comment">           * `ok` = &lt;it returned non-null&gt;).  @todo Consider using timeout sync_request() overload just in case. */</span></div>
<div class="line"><a id="l02019" name="l02019"></a><span class="lineno"> 2019</span>          ok = (idx == (n_init_channels - 1))</div>
<div class="line"><a id="l02020" name="l02020"></a><span class="lineno"> 2020</span>                 ? bool(m_master_channel-&gt;sync_request(open_channel_req_msg, <span class="keyword">nullptr</span>, &amp;err_code))</div>
<div class="line"><a id="l02021" name="l02021"></a><span class="lineno"> 2021</span>                 : (m_master_channel-&gt;send(open_channel_req_msg, <span class="keyword">nullptr</span>, &amp;err_code)</div>
<div class="line"><a id="l02022" name="l02022"></a><span class="lineno"> 2022</span>                      &amp;&amp; (!err_code));</div>
<div class="line"><a id="l02023" name="l02023"></a><span class="lineno"> 2023</span>        } <span class="comment">// for (idx in n_init_channels)</span></div>
<div class="line"><a id="l02024" name="l02024"></a><span class="lineno"> 2024</span> </div>
<div class="line"><a id="l02025" name="l02025"></a><span class="lineno"> 2025</span>        <span class="keywordflow">if</span> (ok)</div>
<div class="line"><a id="l02026" name="l02026"></a><span class="lineno"> 2026</span>        {</div>
<div class="line"><a id="l02027" name="l02027"></a><span class="lineno"> 2027</span>          <span class="comment">// Excellent.  We can go to almost-PEER state/emit everything.</span></div>
<div class="line"><a id="l02028" name="l02028"></a><span class="lineno"> 2028</span>          FLOW_LOG_INFO(<span class="stringliteral">&quot;Server session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Accept-log-in: Init-channels opened/client acked.  &quot;</span></div>
<div class="line"><a id="l02029" name="l02029"></a><span class="lineno"> 2029</span>                        <span class="stringliteral">&quot;Will go to almost-PEER state and report to user via on-accept-log-in &quot;</span></div>
<div class="line"><a id="l02030" name="l02030"></a><span class="lineno"> 2030</span>                        <span class="stringliteral">&quot;handler (user must then invoke init_handlers() on the Server_session to reach PEER &quot;</span></div>
<div class="line"><a id="l02031" name="l02031"></a><span class="lineno"> 2031</span>                        <span class="stringliteral">&quot;state).&quot;</span>);</div>
<div class="line"><a id="l02032" name="l02032"></a><span class="lineno"> 2032</span>          <span class="keywordtype">size_t</span> idx = 0;</div>
<div class="line"><a id="l02033" name="l02033"></a><span class="lineno"> 2033</span>          <span class="keywordflow">if</span> (init_channels_by_cli_req)</div>
<div class="line"><a id="l02034" name="l02034"></a><span class="lineno"> 2034</span>          {</div>
<div class="line"><a id="l02035" name="l02035"></a><span class="lineno"> 2035</span>            <span class="keyword">auto</span>&amp; init_channels_ref = *init_channels_by_cli_req;</div>
<div class="line"><a id="l02036" name="l02036"></a><span class="lineno"> 2036</span>            init_channels_ref.clear();</div>
<div class="line"><a id="l02037" name="l02037"></a><span class="lineno"> 2037</span>            init_channels_ref.reserve(n_init_channels_by_cli_req);</div>
<div class="line"><a id="l02038" name="l02038"></a><span class="lineno"> 2038</span>            <span class="keywordflow">for</span> (; idx != n_init_channels_by_cli_req; ++idx)</div>
<div class="line"><a id="l02039" name="l02039"></a><span class="lineno"> 2039</span>            {</div>
<div class="line"><a id="l02040" name="l02040"></a><span class="lineno"> 2040</span>              init_channels_ref.emplace_back(std::move(init_channels[idx]));</div>
<div class="line"><a id="l02041" name="l02041"></a><span class="lineno"> 2041</span>              FLOW_LOG_INFO(<span class="stringliteral">&quot;Server session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Emitting init-channel (cli-requested): &quot;</span></div>
<div class="line"><a id="l02042" name="l02042"></a><span class="lineno"> 2042</span>                            <span class="stringliteral">&quot;[&quot;</span> &lt;&lt; init_channels_ref.back() &lt;&lt; <span class="stringliteral">&quot;].&quot;</span>);</div>
<div class="line"><a id="l02043" name="l02043"></a><span class="lineno"> 2043</span>            }</div>
<div class="line"><a id="l02044" name="l02044"></a><span class="lineno"> 2044</span>          }</div>
<div class="line"><a id="l02045" name="l02045"></a><span class="lineno"> 2045</span>          <span class="keywordflow">if</span> (init_channels_by_srv_req)</div>
<div class="line"><a id="l02046" name="l02046"></a><span class="lineno"> 2046</span>          {</div>
<div class="line"><a id="l02047" name="l02047"></a><span class="lineno"> 2047</span>            <span class="keyword">auto</span>&amp; init_channels_ref = *init_channels_by_srv_req;</div>
<div class="line"><a id="l02048" name="l02048"></a><span class="lineno"> 2048</span>            init_channels_ref.clear();</div>
<div class="line"><a id="l02049" name="l02049"></a><span class="lineno"> 2049</span>            init_channels_ref.reserve(n_init_channels - idx);</div>
<div class="line"><a id="l02050" name="l02050"></a><span class="lineno"> 2050</span>            <span class="keywordflow">for</span> (; idx != n_init_channels; ++idx)</div>
<div class="line"><a id="l02051" name="l02051"></a><span class="lineno"> 2051</span>            {</div>
<div class="line"><a id="l02052" name="l02052"></a><span class="lineno"> 2052</span>              init_channels_ref.emplace_back(std::move(init_channels[idx]));</div>
<div class="line"><a id="l02053" name="l02053"></a><span class="lineno"> 2053</span>              FLOW_LOG_INFO(<span class="stringliteral">&quot;Server session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Emitting init-channel (srv-requested): &quot;</span></div>
<div class="line"><a id="l02054" name="l02054"></a><span class="lineno"> 2054</span>                            <span class="stringliteral">&quot;[&quot;</span> &lt;&lt; init_channels_ref.back() &lt;&lt; <span class="stringliteral">&quot;].&quot;</span>);</div>
<div class="line"><a id="l02055" name="l02055"></a><span class="lineno"> 2055</span>            }</div>
<div class="line"><a id="l02056" name="l02056"></a><span class="lineno"> 2056</span>          }</div>
<div class="line"><a id="l02057" name="l02057"></a><span class="lineno"> 2057</span>          assert(idx == n_init_channels);</div>
<div class="line"><a id="l02058" name="l02058"></a><span class="lineno"> 2058</span>          <span class="comment">// OK: Channel out-args all the way from async_connect() have been set.  Now same for mdt; invoke handler.</span></div>
<div class="line"><a id="l02059" name="l02059"></a><span class="lineno"> 2059</span> </div>
<div class="line"><a id="l02060" name="l02060"></a><span class="lineno"> 2060</span>          <span class="keywordflow">if</span> (mdt_from_cli_or_null)</div>
<div class="line"><a id="l02061" name="l02061"></a><span class="lineno"> 2061</span>          {</div>
<div class="line"><a id="l02062" name="l02062"></a><span class="lineno"> 2062</span>            *mdt_from_cli_or_null = std::move(mdt_from_cli);</div>
<div class="line"><a id="l02063" name="l02063"></a><span class="lineno"> 2063</span>          }</div>
<div class="line"><a id="l02064" name="l02064"></a><span class="lineno"> 2064</span> </div>
<div class="line"><a id="l02065" name="l02065"></a><span class="lineno"> 2065</span>          assert(!err_code);</div>
<div class="line"><a id="l02066" name="l02066"></a><span class="lineno"> 2066</span>        } <span class="comment">// if (ok)</span></div>
<div class="line"><a id="l02067" name="l02067"></a><span class="lineno"> 2067</span>        <span class="keywordflow">else</span> <span class="comment">// if (!ok)</span></div>
<div class="line"><a id="l02068" name="l02068"></a><span class="lineno"> 2068</span>        {</div>
<div class="line"><a id="l02069" name="l02069"></a><span class="lineno"> 2069</span>          <span class="comment">/* Something (create_channel_and_resources() or send()) failed; loop aborted.</span></div>
<div class="line"><a id="l02070" name="l02070"></a><span class="lineno"> 2070</span><span class="comment">           * We won&#39;t emit any of init_channels, so it&#39;ll all get cleaned up fine.  So abort session-open as usual. */</span></div>
<div class="line"><a id="l02071" name="l02071"></a><span class="lineno"> 2071</span>          <span class="keywordflow">if</span> (!err_code)</div>
<div class="line"><a id="l02072" name="l02072"></a><span class="lineno"> 2072</span>          {</div>
<div class="line"><a id="l02073" name="l02073"></a><span class="lineno"> 2073</span>            FLOW_LOG_TRACE(<span class="stringliteral">&quot;send() synchronously failed; must be an error situation.  Error handler should &quot;</span></div>
<div class="line"><a id="l02074" name="l02074"></a><span class="lineno"> 2074</span>                           <span class="stringliteral">&quot;catch it shortly or has already caught it.&quot;</span>);</div>
<div class="line"><a id="l02075" name="l02075"></a><span class="lineno"> 2075</span>            <span class="keywordflow">return</span>;</div>
<div class="line"><a id="l02076" name="l02076"></a><span class="lineno"> 2076</span>          }</div>
<div class="line"><a id="l02077" name="l02077"></a><span class="lineno"> 2077</span>          <span class="comment">/* else if (err_code) // I.e., we detected new error ourselves.  sync_request()&#39;s TIMEOUT is not</span></div>
<div class="line"><a id="l02078" name="l02078"></a><span class="lineno"> 2078</span><span class="comment">           *                    // channel-hosing, by the way, but to us it&#39;s fatal anyway. */</span></div>
<div class="line"><a id="l02079" name="l02079"></a><span class="lineno"> 2079</span> </div>
<div class="line"><a id="l02080" name="l02080"></a><span class="lineno"> 2080</span>          <span class="comment">// Again: As promised in the various error paths above: error =&gt; end the short-lived master channel.</span></div>
<div class="line"><a id="l02081" name="l02081"></a><span class="lineno"> 2081</span>          m_master_channel.reset();</div>
<div class="line"><a id="l02082" name="l02082"></a><span class="lineno"> 2082</span> </div>
<div class="line"><a id="l02083" name="l02083"></a><span class="lineno"> 2083</span>          FLOW_LOG_WARNING(<span class="stringliteral">&quot;Server session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Accept-log-in: A send() of an init-channel&#39;s info &quot;</span></div>
<div class="line"><a id="l02084" name="l02084"></a><span class="lineno"> 2084</span>                           <span class="stringliteral">&quot;failed (details logged above).  &quot;</span></div>
<div class="line"><a id="l02085" name="l02085"></a><span class="lineno"> 2085</span>                           <span class="stringliteral">&quot;Closing session master channel and reporting to user via &quot;</span></div>
<div class="line"><a id="l02086" name="l02086"></a><span class="lineno"> 2086</span>                           <span class="stringliteral">&quot;on-accept-log-in handler.&quot;</span>);</div>
<div class="line"><a id="l02087" name="l02087"></a><span class="lineno"> 2087</span>        } <span class="comment">// else if (!ok)</span></div>
<div class="line"><a id="l02088" name="l02088"></a><span class="lineno"> 2088</span> </div>
<div class="line"><a id="l02089" name="l02089"></a><span class="lineno"> 2089</span>        <span class="comment">// err_code may me truthy or falsy.</span></div>
<div class="line"><a id="l02090" name="l02090"></a><span class="lineno"> 2090</span>        m_log_in_on_done_func(err_code);</div>
<div class="line"><a id="l02091" name="l02091"></a><span class="lineno"> 2091</span>        FLOW_LOG_TRACE(<span class="stringliteral">&quot;Handler finished.&quot;</span>);</div>
<div class="line"><a id="l02092" name="l02092"></a><span class="lineno"> 2092</span>        m_log_in_on_done_func.clear();</div>
<div class="line"><a id="l02093" name="l02093"></a><span class="lineno"> 2093</span>      }); <span class="comment">// m_async_worker.post()</span></div>
<div class="line"><a id="l02094" name="l02094"></a><span class="lineno"> 2094</span>    }); <span class="comment">// const bool result = m_master_channel-&gt;expect_log_in_request()</span></div>
<div class="line"><a id="l02095" name="l02095"></a><span class="lineno"> 2095</span> </div>
<div class="line"><a id="l02096" name="l02096"></a><span class="lineno"> 2096</span>    <span class="keywordflow">if</span> (!result)</div>
<div class="line"><a id="l02097" name="l02097"></a><span class="lineno"> 2097</span>    {</div>
<div class="line"><a id="l02098" name="l02098"></a><span class="lineno"> 2098</span>      <span class="comment">/* The docs say expect_log_in_request() returns false if:</span></div>
<div class="line"><a id="l02099" name="l02099"></a><span class="lineno"> 2099</span><span class="comment">       * &quot;expect_log_in_request() has already been invoked, if log-in phase is not active or active in the client</span></div>
<div class="line"><a id="l02100" name="l02100"></a><span class="lineno"> 2100</span><span class="comment">       * role, or if a prior error has hosed the owned Channel.&quot;  Only the latter is possible in our case.</span></div>
<div class="line"><a id="l02101" name="l02101"></a><span class="lineno"> 2101</span><span class="comment">       * on_master_channel_error() shall issue m_log_in_on_done_func(truthy) in our stead. */</span></div>
<div class="line"><a id="l02102" name="l02102"></a><span class="lineno"> 2102</span>      FLOW_LOG_TRACE(<span class="stringliteral">&quot;expect_log_in_request() synchronously failed; must be an error situation.  Error handler should &quot;</span></div>
<div class="line"><a id="l02103" name="l02103"></a><span class="lineno"> 2103</span>                     <span class="stringliteral">&quot;catch it shortly or has already caught it.&quot;</span>);</div>
<div class="line"><a id="l02104" name="l02104"></a><span class="lineno"> 2104</span>    }</div>
<div class="line"><a id="l02105" name="l02105"></a><span class="lineno"> 2105</span>  }); <span class="comment">// m_async_worker.post()</span></div>
<div class="line"><a id="l02106" name="l02106"></a><span class="lineno"> 2106</span>} <span class="comment">// Server_session_impl::async_accept_log_in()</span></div>
<div class="line"><a id="l02107" name="l02107"></a><span class="lineno"> 2107</span> </div>
<div class="line"><a id="l02108" name="l02108"></a><span class="lineno"> 2108</span><a class="code hl_define" href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp.html#aea842eaa966995a5ff8abf5672a25a5f">TEMPLATE_SRV_SESSION_IMPL</a></div>
<div class="line"><a id="l02109" name="l02109"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#aeccf8c9a6774d25bd4274962d69fc0e9"> 2109</a></span><span class="keywordtype">void</span> CLASS_SRV_SESSION_IMPL::on_master_channel_error(<span class="keyword">const</span> <a class="code hl_typedef" href="namespaceipc.html#aa3192e586cc45d3e7c22463bf2760f89">Error_code</a>&amp; err_code)</div>
<div class="line"><a id="l02110" name="l02110"></a><span class="lineno"> 2110</span>{</div>
<div class="line"><a id="l02111" name="l02111"></a><span class="lineno"> 2111</span>  <span class="comment">// We are in thread W.</span></div>
<div class="line"><a id="l02112" name="l02112"></a><span class="lineno"> 2112</span> </div>
<div class="line"><a id="l02113" name="l02113"></a><span class="lineno"> 2113</span>  <span class="comment">/* (If you are comparing this to Client_session::on_master_channel_error(), you might notice this is a lot simpler</span></div>
<div class="line"><a id="l02114" name="l02114"></a><span class="lineno"> 2114</span><span class="comment">   * (at least in the log-in phase); that is because Client_session supports multiple async_connect()s in series</span></div>
<div class="line"><a id="l02115" name="l02115"></a><span class="lineno"> 2115</span><span class="comment">   * (if 1 or more fail), so m_master_channel can be nullified and then again constructed.  In our case</span></div>
<div class="line"><a id="l02116" name="l02116"></a><span class="lineno"> 2116</span><span class="comment">   * async_accept_log_in() is a protected API, made public via Server_session_dtl to Session_server</span></div>
<div class="line"><a id="l02117" name="l02117"></a><span class="lineno"> 2117</span><span class="comment">   * only, and therefore (due to having a limited internal use case) can be only called 1x, by contract.</span></div>
<div class="line"><a id="l02118" name="l02118"></a><span class="lineno"> 2118</span><span class="comment">   * Hence there is no chance of getting an err_code that pertains to some past m_master_channel and all that</span></div>
<div class="line"><a id="l02119" name="l02119"></a><span class="lineno"> 2119</span><span class="comment">   * stuff; so we don&#39;t need that observer weak_ptr stuff.  It&#39;s a much simpler state machine (there&#39;s no m_state</span></div>
<div class="line"><a id="l02120" name="l02120"></a><span class="lineno"> 2120</span><span class="comment">   * for instance).) */</span></div>
<div class="line"><a id="l02121" name="l02121"></a><span class="lineno"> 2121</span> </div>
<div class="line"><a id="l02122" name="l02122"></a><span class="lineno"> 2122</span>  <span class="keywordflow">if</span> (!m_master_channel)</div>
<div class="line"><a id="l02123" name="l02123"></a><span class="lineno"> 2123</span>  {</div>
<div class="line"><a id="l02124" name="l02124"></a><span class="lineno"> 2124</span>    FLOW_LOG_TRACE(<span class="stringliteral">&quot;Server session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Session master channel reported error; but the source &quot;</span></div>
<div class="line"><a id="l02125" name="l02125"></a><span class="lineno"> 2125</span>                   <span class="stringliteral">&quot;master channel has since been destroyed; so presumably the log-in request was received &quot;</span></div>
<div class="line"><a id="l02126" name="l02126"></a><span class="lineno"> 2126</span>                   <span class="stringliteral">&quot;from remote client, and it was invalid, so the channel was destroyed by our log-in request &quot;</span></div>
<div class="line"><a id="l02127" name="l02127"></a><span class="lineno"> 2127</span>                   <span class="stringliteral">&quot;handler; but coincidentally before that destruction could occur an incoming-direction &quot;</span></div>
<div class="line"><a id="l02128" name="l02128"></a><span class="lineno"> 2128</span>                   <span class="stringliteral">&quot;channel error occurred.  The error does not matter anymore.  Ignoring.&quot;</span>);</div>
<div class="line"><a id="l02129" name="l02129"></a><span class="lineno"> 2129</span>    <span class="keywordflow">return</span>;</div>
<div class="line"><a id="l02130" name="l02130"></a><span class="lineno"> 2130</span>  }</div>
<div class="line"><a id="l02131" name="l02131"></a><span class="lineno"> 2131</span>  <span class="comment">// else</span></div>
<div class="line"><a id="l02132" name="l02132"></a><span class="lineno"> 2132</span> </div>
<div class="line"><a id="l02133" name="l02133"></a><span class="lineno"> 2133</span>  <span class="comment">// Might want to read our class doc header impl section regarding error handling.  Then come back here.</span></div>
<div class="line"><a id="l02134" name="l02134"></a><span class="lineno"> 2134</span> </div>
<div class="line"><a id="l02135" name="l02135"></a><span class="lineno"> 2135</span>  <span class="keywordflow">if</span> (!m_log_in_on_done_func.empty())</div>
<div class="line"><a id="l02136" name="l02136"></a><span class="lineno"> 2136</span>  {</div>
<div class="line"><a id="l02137" name="l02137"></a><span class="lineno"> 2137</span>    <span class="comment">// We are in logging-in phase still.</span></div>
<div class="line"><a id="l02138" name="l02138"></a><span class="lineno"> 2138</span>    FLOW_LOG_WARNING(<span class="stringliteral">&quot;Server session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Log-in: Session master channel reported error &quot;</span></div>
<div class="line"><a id="l02139" name="l02139"></a><span class="lineno"> 2139</span>                     <span class="stringliteral">&quot;[&quot;</span> &lt;&lt; err_code &lt;&lt; <span class="stringliteral">&quot;] [&quot;</span> &lt;&lt; err_code.message() &lt;&lt; <span class="stringliteral">&quot;].  Will go back to NULL &quot;</span></div>
<div class="line"><a id="l02140" name="l02140"></a><span class="lineno"> 2140</span>                     <span class="stringliteral">&quot;state and report to user via on-accept-log-in handler.&quot;</span>);</div>
<div class="line"><a id="l02141" name="l02141"></a><span class="lineno"> 2141</span> </div>
<div class="line"><a id="l02142" name="l02142"></a><span class="lineno"> 2142</span>    <span class="comment">/* Channel incoming-direction error while awaiting log-in request.  Might as well clean this up; though</span></div>
<div class="line"><a id="l02143" name="l02143"></a><span class="lineno"> 2143</span><span class="comment">     * it would be cleaned up presumably pretty soon, as Session_server will destroy *this. */</span></div>
<div class="line"><a id="l02144" name="l02144"></a><span class="lineno"> 2144</span>    m_master_channel.reset();</div>
<div class="line"><a id="l02145" name="l02145"></a><span class="lineno"> 2145</span> </div>
<div class="line"><a id="l02146" name="l02146"></a><span class="lineno"> 2146</span>    m_log_in_on_done_func(err_code);</div>
<div class="line"><a id="l02147" name="l02147"></a><span class="lineno"> 2147</span>    FLOW_LOG_TRACE(<span class="stringliteral">&quot;Handler finished.&quot;</span>);</div>
<div class="line"><a id="l02148" name="l02148"></a><span class="lineno"> 2148</span>    m_log_in_on_done_func.clear();</div>
<div class="line"><a id="l02149" name="l02149"></a><span class="lineno"> 2149</span>    <span class="keywordflow">return</span>;</div>
<div class="line"><a id="l02150" name="l02150"></a><span class="lineno"> 2150</span>  } <span class="comment">// if (!m_log_in_on_done_func.empty()): We are in logged-in phase: almost-PEER state or PEER state.</span></div>
<div class="line"><a id="l02151" name="l02151"></a><span class="lineno"> 2151</span> </div>
<div class="line"><a id="l02152" name="l02152"></a><span class="lineno"> 2152</span>  <span class="keywordflow">if</span> (!handlers_are_set())</div>
<div class="line"><a id="l02153" name="l02153"></a><span class="lineno"> 2153</span>  {</div>
<div class="line"><a id="l02154" name="l02154"></a><span class="lineno"> 2154</span>    FLOW_LOG_WARNING(<span class="stringliteral">&quot;Server session [&quot;</span> &lt;&lt; *<span class="keyword">this</span> &lt;&lt; <span class="stringliteral">&quot;]: Almost-PEER state: Session master channel reported error &quot;</span></div>
<div class="line"><a id="l02155" name="l02155"></a><span class="lineno"> 2155</span>                     <span class="stringliteral">&quot;[&quot;</span> &lt;&lt; err_code &lt;&lt; <span class="stringliteral">&quot;] [&quot;</span> &lt;&lt; err_code.message() &lt;&lt; <span class="stringliteral">&quot;].  Recording it to emit once &quot;</span></div>
<div class="line"><a id="l02156" name="l02156"></a><span class="lineno"> 2156</span>                     <span class="stringliteral">&quot;user advances us to PEER state by setting handlers.&quot;</span>);</div>
<div class="line"><a id="l02157" name="l02157"></a><span class="lineno"> 2157</span> </div>
<div class="line"><a id="l02158" name="l02158"></a><span class="lineno"> 2158</span>    assert((!m_pre_init_err_code) &amp;&amp; <span class="stringliteral">&quot;struc::Channel should emit no more than one fatal error.&quot;</span>);</div>
<div class="line"><a id="l02159" name="l02159"></a><span class="lineno"> 2159</span>    m_pre_init_err_code = err_code;</div>
<div class="line"><a id="l02160" name="l02160"></a><span class="lineno"> 2160</span>    <span class="keywordflow">return</span>;</div>
<div class="line"><a id="l02161" name="l02161"></a><span class="lineno"> 2161</span>  }</div>
<div class="line"><a id="l02162" name="l02162"></a><span class="lineno"> 2162</span>  <span class="comment">// else if (handlers_are_set()): We are in PEER state.  Here the logic is similar to Client_session_impl again:</span></div>
<div class="line"><a id="l02163" name="l02163"></a><span class="lineno"> 2163</span> </div>
<div class="line"><a id="l02164" name="l02164"></a><span class="lineno"> 2164</span>  <span class="keywordflow">if</span> (!Base::hosed())</div>
<div class="line"><a id="l02165" name="l02165"></a><span class="lineno"> 2165</span>  {</div>
<div class="line"><a id="l02166" name="l02166"></a><span class="lineno"> 2166</span>    Base::hose(err_code);</div>
<div class="line"><a id="l02167" name="l02167"></a><span class="lineno"> 2167</span>  }</div>
<div class="line"><a id="l02168" name="l02168"></a><span class="lineno"> 2168</span> </div>
<div class="line"><a id="l02169" name="l02169"></a><span class="lineno"> 2169</span>  <span class="keywordflow">if</span> <span class="keyword">constexpr</span>(S_GRACEFUL_FINISH_REQUIRED)</div>
<div class="line"><a id="l02170" name="l02170"></a><span class="lineno"> 2170</span>  {</div>
<div class="line"><a id="l02171" name="l02171"></a><span class="lineno"> 2171</span>    m_graceful_finisher-&gt;on_master_channel_hosed();</div>
<div class="line"><a id="l02172" name="l02172"></a><span class="lineno"> 2172</span>  }</div>
<div class="line"><a id="l02173" name="l02173"></a><span class="lineno"> 2173</span>} <span class="comment">// Server_session_impl::on_master_channel_error()</span></div>
<div class="line"><a id="l02174" name="l02174"></a><span class="lineno"> 2174</span> </div>
<div class="line"><a id="l02175" name="l02175"></a><span class="lineno"> 2175</span><a class="code hl_define" href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp.html#aea842eaa966995a5ff8abf5672a25a5f">TEMPLATE_SRV_SESSION_IMPL</a></div>
<div class="line"><a id="l02176" name="l02176"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#a0992cbc57bf346d6b8df191f2dcb9188"> 2176</a></span><span class="keyword">const</span> <span class="keyword">typename</span> CLASS_SRV_SESSION_IMPL::Base&amp; CLASS_SRV_SESSION_IMPL::base()<span class="keyword"> const</span></div>
<div class="line"><a id="l02177" name="l02177"></a><span class="lineno"> 2177</span><span class="keyword"></span>{</div>
<div class="line"><a id="l02178" name="l02178"></a><span class="lineno"> 2178</span>  <span class="keywordflow">return</span> *(<span class="keyword">static_cast&lt;</span><span class="keyword">const </span><a class="code hl_class" href="classipc_1_1session_1_1Session__base.html">Base</a>*<span class="keyword">&gt;</span>(<span class="keyword">this</span>));</div>
<div class="line"><a id="l02179" name="l02179"></a><span class="lineno"> 2179</span>}</div>
<div class="line"><a id="l02180" name="l02180"></a><span class="lineno"> 2180</span> </div>
<div class="line"><a id="l02181" name="l02181"></a><span class="lineno"> 2181</span><a class="code hl_define" href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp.html#aea842eaa966995a5ff8abf5672a25a5f">TEMPLATE_SRV_SESSION_IMPL</a></div>
<div class="line"><a id="l02182" name="l02182"></a><span class="lineno"> 2182</span><span class="keyword">template</span>&lt;<span class="keyword">typename</span> Task&gt;</div>
<div class="line"><a id="l02183" name="l02183"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#a2276a6fd556861a9e0856360fde58158"> 2183</a></span><span class="keywordtype">void</span> CLASS_SRV_SESSION_IMPL::sub_class_set_deinit_func(<a class="code hl_typedef" href="namespaceipc_1_1util.html#a31e67d3a017477a04b313927e2f2c733">Task</a>&amp;&amp; task)</div>
<div class="line"><a id="l02184" name="l02184"></a><span class="lineno"> 2184</span>{</div>
<div class="line"><a id="l02185" name="l02185"></a><span class="lineno"> 2185</span>  m_deinit_func_or_empty = std::move(task);</div>
<div class="line"><a id="l02186" name="l02186"></a><span class="lineno"> 2186</span>}</div>
<div class="line"><a id="l02187" name="l02187"></a><span class="lineno"> 2187</span> </div>
<div class="line"><a id="l02188" name="l02188"></a><span class="lineno"> 2188</span><a class="code hl_define" href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp.html#aea842eaa966995a5ff8abf5672a25a5f">TEMPLATE_SRV_SESSION_IMPL</a></div>
<div class="line"><a id="l02189" name="l02189"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#a149a11c639d26b8a21279724079f6c2a"> 2189</a></span>flow::async::Single_thread_task_loop* CLASS_SRV_SESSION_IMPL::async_worker()</div>
<div class="line"><a id="l02190" name="l02190"></a><span class="lineno"> 2190</span>{</div>
<div class="line"><a id="l02191" name="l02191"></a><span class="lineno"> 2191</span>  <span class="keywordflow">return</span> &amp;m_async_worker;</div>
<div class="line"><a id="l02192" name="l02192"></a><span class="lineno"> 2192</span>}</div>
<div class="line"><a id="l02193" name="l02193"></a><span class="lineno"> 2193</span> </div>
<div class="line"><a id="l02194" name="l02194"></a><span class="lineno"> 2194</span><a class="code hl_define" href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp.html#aea842eaa966995a5ff8abf5672a25a5f">TEMPLATE_SRV_SESSION_IMPL</a></div>
<div class="line"><a id="l02195" name="l02195"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#a14d68714c197ba58b4cb485262fb9d51"> 2195</a></span><span class="keyword">typename</span> CLASS_SRV_SESSION_IMPL::Master_structured_channel* CLASS_SRV_SESSION_IMPL::master_channel()</div>
<div class="line"><a id="l02196" name="l02196"></a><span class="lineno"> 2196</span>{</div>
<div class="line"><a id="l02197" name="l02197"></a><span class="lineno"> 2197</span>  <span class="keywordflow">return</span> m_master_channel.get();</div>
<div class="line"><a id="l02198" name="l02198"></a><span class="lineno"> 2198</span>}</div>
<div class="line"><a id="l02199" name="l02199"></a><span class="lineno"> 2199</span> </div>
<div class="line"><a id="l02200" name="l02200"></a><span class="lineno"> 2200</span><a class="code hl_define" href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp.html#aea842eaa966995a5ff8abf5672a25a5f">TEMPLATE_SRV_SESSION_IMPL</a></div>
<div class="line"><a id="l02201" name="l02201"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#aaa570a2ceb242370eeccca85d806fbbf"> 2201</a></span><span class="keyword">const</span> <span class="keyword">typename</span> CLASS_SRV_SESSION_IMPL::Master_structured_channel&amp; CLASS_SRV_SESSION_IMPL::master_channel_const()<span class="keyword"> const</span></div>
<div class="line"><a id="l02202" name="l02202"></a><span class="lineno"> 2202</span><span class="keyword"></span>{</div>
<div class="line"><a id="l02203" name="l02203"></a><span class="lineno"> 2203</span>  <span class="keywordflow">return</span> *m_master_channel;</div>
<div class="line"><a id="l02204" name="l02204"></a><span class="lineno"> 2204</span>}</div>
<div class="line"><a id="l02205" name="l02205"></a><span class="lineno"> 2205</span> </div>
<div class="line"><a id="l02206" name="l02206"></a><span class="lineno"> 2206</span><a class="code hl_define" href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp.html#aea842eaa966995a5ff8abf5672a25a5f">TEMPLATE_SRV_SESSION_IMPL</a></div>
<div class="line"><a id="l02207" name="l02207"></a><span class="lineno"><a class="line" href="classipc_1_1session_1_1Server__session__impl.html#a88b5e68821f26cfab86feb8b4dc5702a"> 2207</a></span>std::ostream&amp; <a class="code hl_function" href="namespaceipc_1_1session.html#a6b2f9a90ac9cc5098d9b90e7f547c97e">operator&lt;&lt;</a>(std::ostream&amp; os, <span class="keyword">const</span> <a class="code hl_define" href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp.html#a97654d0122c90a30b35a270e840ad9b7">CLASS_SRV_SESSION_IMPL</a>&amp; val)</div>
<div class="line"><a id="l02208" name="l02208"></a><span class="lineno"> 2208</span>{</div>
<div class="line"><a id="l02209" name="l02209"></a><span class="lineno"> 2209</span>  <span class="keyword">using </span>std::string;</div>
<div class="line"><a id="l02210" name="l02210"></a><span class="lineno"> 2210</span> </div>
<div class="line"><a id="l02211" name="l02211"></a><span class="lineno"> 2211</span>  <span class="comment">/* Let&#39;s print only really key stuff here; various internal code likes to ostream&lt;&lt; *this session (`val` to us),</span></div>
<div class="line"><a id="l02212" name="l02212"></a><span class="lineno"> 2212</span><span class="comment">   * and we don&#39;t want to be treating stuff here as immutable or safe to access, even though it might change</span></div>
<div class="line"><a id="l02213" name="l02213"></a><span class="lineno"> 2213</span><span class="comment">   * concurrently.  So we intentionally just print the Client_app and the Server_app (which are themselves immutable,</span></div>
<div class="line"><a id="l02214" name="l02214"></a><span class="lineno"> 2214</span><span class="comment">   * but the ref/ptr to each inside `val` might not be).  Now, for Server_session, m_srv_app_ref is immutable</span></div>
<div class="line"><a id="l02215" name="l02215"></a><span class="lineno"> 2215</span><span class="comment">   * (it&#39;s a ref!).  cli_app_ptr(), though, might change in one spot.  For that reason Session_base declared it</span></div>
<div class="line"><a id="l02216" name="l02216"></a><span class="lineno"> 2216</span><span class="comment">   * as atomic&lt;&gt;.  So the following is safe. */</span></div>
<div class="line"><a id="l02217" name="l02217"></a><span class="lineno"> 2217</span> </div>
<div class="line"><a id="l02218" name="l02218"></a><span class="lineno"> 2218</span>  <span class="keyword">const</span> <span class="keyword">auto</span> cli_app_ptr = val.cli_app_ptr(); <span class="comment">// Very rarely this could change underneath us (atomic&lt;&gt;ally).</span></div>
<div class="line"><a id="l02219" name="l02219"></a><span class="lineno"> 2219</span>  os &lt;&lt; <span class="charliteral">&#39;[&#39;</span> &lt;&lt; val.m_srv_app_ref.m_name &lt;&lt; <span class="stringliteral">&quot;&lt;-&quot;</span> &lt;&lt; (cli_app_ptr ? cli_app_ptr-&gt;m_name : string(<span class="stringliteral">&quot;unknown-cli&quot;</span>));</div>
<div class="line"><a id="l02220" name="l02220"></a><span class="lineno"> 2220</span>  <span class="keywordflow">if</span> <span class="keyword">constexpr</span>(CLASS_SRV_SESSION_IMPL::S_SHM_ENABLED)</div>
<div class="line"><a id="l02221" name="l02221"></a><span class="lineno"> 2221</span>  {</div>
<div class="line"><a id="l02222" name="l02222"></a><span class="lineno"> 2222</span>    os &lt;&lt; <span class="stringliteral">&quot; | shm_type=&quot;</span> &lt;&lt; int(CLASS_SRV_SESSION_IMPL::S_SHM_TYPE);</div>
<div class="line"><a id="l02223" name="l02223"></a><span class="lineno"> 2223</span>  }</div>
<div class="line"><a id="l02224" name="l02224"></a><span class="lineno"> 2224</span>  <span class="keywordflow">return</span> os &lt;&lt; <span class="stringliteral">&quot;]@&quot;</span> &lt;&lt; <span class="keyword">static_cast&lt;</span><span class="keyword">const </span><span class="keywordtype">void</span>*<span class="keyword">&gt;</span>(&amp;val);</div>
<div class="line"><a id="l02225" name="l02225"></a><span class="lineno"> 2225</span>}</div>
<div class="line"><a id="l02226" name="l02226"></a><span class="lineno"> 2226</span> </div>
<div class="line"><a id="l02227" name="l02227"></a><span class="lineno"> 2227</span><span class="preprocessor">#undef CLASS_SRV_SESSION_IMPL</span></div>
<div class="line"><a id="l02228" name="l02228"></a><span class="lineno"> 2228</span><span class="preprocessor">#undef TEMPLATE_SRV_SESSION_IMPL</span></div>
<div class="line"><a id="l02229" name="l02229"></a><span class="lineno"> 2229</span> </div>
<div class="line"><a id="l02230" name="l02230"></a><span class="lineno"> 2230</span>} <span class="comment">// namespace ipc::session</span></div>
<div class="ttc" id="aclassipc_1_1session_1_1Server__session__impl_html"><div class="ttname"><a href="classipc_1_1session_1_1Server__session__impl.html">ipc::session::Server_session_impl</a></div><div class="ttdoc">Internal, non-movable pImpl-lite implementation of Server_session_mv class template.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp_source.html#l00185">server_session_impl.hpp:188</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Server__session__impl_html_a005fcbc9ee215531c03d17fcc49ef544"><div class="ttname"><a href="classipc_1_1session_1_1Server__session__impl.html#a005fcbc9ee215531c03d17fcc49ef544">ipc::session::Server_session_impl::S_MQS_ENABLED</a></div><div class="ttdeci">static constexpr bool S_MQS_ENABLED</div><div class="ttdoc">See Server_session_mv counterpart.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp_source.html#l00237">server_session_impl.hpp:237</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Server__session__impl_html_a02a0feffbe59da064cbf33ba33eb4dac"><div class="ttname"><a href="classipc_1_1session_1_1Server__session__impl.html#a02a0feffbe59da064cbf33ba33eb4dac">ipc::session::Server_session_impl::m_deinit_func_or_empty</a></div><div class="ttdeci">Function&lt; void()&gt; m_deinit_func_or_empty</div><div class="ttdoc">See sub_class_set_deinit_func(). .empty() unless that was called at least once.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp_source.html#l00656">server_session_impl.hpp:656</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Server__session__impl_html_a0992cbc57bf346d6b8df191f2dcb9188"><div class="ttname"><a href="classipc_1_1session_1_1Server__session__impl.html#a0992cbc57bf346d6b8df191f2dcb9188">ipc::session::Server_session_impl::base</a></div><div class="ttdeci">const Base &amp; base() const</div><div class="ttdoc">See Server_session_mv counterpart.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp_source.html#l02176">server_session_impl.hpp:2176</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Server__session__impl_html_a0dc599111ce0b4b6d8cd003559e6c01c"><div class="ttname"><a href="classipc_1_1session_1_1Server__session__impl.html#a0dc599111ce0b4b6d8cd003559e6c01c">ipc::session::Server_session_impl::S_GRACEFUL_FINISH_REQUIRED</a></div><div class="ttdeci">static constexpr bool S_GRACEFUL_FINISH_REQUIRED</div><div class="ttdoc">Short-hand for template parameter knob S_GRACEFUL_FINISH_REQUIRED_V: see class template doc header.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp_source.html#l00243">server_session_impl.hpp:243</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Server__session__impl_html_a138956765a655240080491157f316167"><div class="ttname"><a href="classipc_1_1session_1_1Server__session__impl.html#a138956765a655240080491157f316167">ipc::session::Server_session_impl::mdt_builder</a></div><div class="ttdeci">Mdt_builder_ptr mdt_builder()</div><div class="ttdoc">See Server_session_mv counterpart.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp_source.html#l00985">server_session_impl.hpp:985</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Server__session__impl_html_a145389df1784d5242adf69e2cc9826cd"><div class="ttname"><a href="classipc_1_1session_1_1Server__session__impl.html#a145389df1784d5242adf69e2cc9826cd">ipc::session::Server_session_impl::~Server_session_impl</a></div><div class="ttdeci">~Server_session_impl()</div><div class="ttdoc">See Server_session_mv counterpart.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp_source.html#l00784">server_session_impl.hpp:784</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Server__session__impl_html_a149a11c639d26b8a21279724079f6c2a"><div class="ttname"><a href="classipc_1_1session_1_1Server__session__impl.html#a149a11c639d26b8a21279724079f6c2a">ipc::session::Server_session_impl::async_worker</a></div><div class="ttdeci">flow::async::Single_thread_task_loop * async_worker()</div><div class="ttdoc">Utility for sub-classes: provides ability to schedule or post tasks onto thread W.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp_source.html#l02189">server_session_impl.hpp:2189</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Server__session__impl_html_a14d68714c197ba58b4cb485262fb9d51"><div class="ttname"><a href="classipc_1_1session_1_1Server__session__impl.html#a14d68714c197ba58b4cb485262fb9d51">ipc::session::Server_session_impl::master_channel</a></div><div class="ttdeci">Master_structured_channel * master_channel()</div><div class="ttdoc">Utility for sub-classes: provides ability to do work on the session master channel after our async_ac...</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp_source.html#l02195">server_session_impl.hpp:2195</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Server__session__impl_html_a1ded7990451b90f29e11f8fa7ce0e80b"><div class="ttname"><a href="classipc_1_1session_1_1Server__session__impl.html#a1ded7990451b90f29e11f8fa7ce0e80b">ipc::session::Server_session_impl::S_SHM_ENABLED</a></div><div class="ttdeci">static constexpr bool S_SHM_ENABLED</div><div class="ttdoc">See Session_mv counterpart.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp_source.html#l00231">server_session_impl.hpp:231</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Server__session__impl_html_a2276a6fd556861a9e0856360fde58158"><div class="ttname"><a href="classipc_1_1session_1_1Server__session__impl.html#a2276a6fd556861a9e0856360fde58158">ipc::session::Server_session_impl::sub_class_set_deinit_func</a></div><div class="ttdeci">void sub_class_set_deinit_func(Task &amp;&amp;task)</div><div class="ttdoc">Utility for sub-classes: ensures that task() is invoked near the end of *this dtor's execution,...</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp_source.html#l02183">server_session_impl.hpp:2183</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Server__session__impl_html_a22e1464a8bc4b806bf3a91e932b31813"><div class="ttname"><a href="classipc_1_1session_1_1Server__session__impl.html#a22e1464a8bc4b806bf3a91e932b31813">ipc::session::Server_session_impl::session_token</a></div><div class="ttdeci">const Session_token &amp; session_token() const</div><div class="ttdoc">See Server_session_mv counterpart.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp_source.html#l00951">server_session_impl.hpp:951</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Server__session__impl_html_a28503a7c6622aacc7e08d4904da10da3"><div class="ttname"><a href="classipc_1_1session_1_1Server__session__impl.html#a28503a7c6622aacc7e08d4904da10da3">ipc::session::Server_session_impl::dtor_async_worker_stop</a></div><div class="ttdeci">void dtor_async_worker_stop()</div><div class="ttdoc">Analogous to Client_session_impl::dtor_async_worker_stop(). See that doc header.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp_source.html#l00708">server_session_impl.hpp:708</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Server__session__impl_html_a3bc90eb872c3f4d4ff65039a4a36b166"><div class="ttname"><a href="classipc_1_1session_1_1Server__session__impl.html#a3bc90eb872c3f4d4ff65039a4a36b166">ipc::session::Server_session_impl::Master_structured_channel</a></div><div class="ttdeci">typename Base::Master_structured_channel Master_structured_channel</div><div class="ttdoc">See Session_base.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp_source.html#l00376">server_session_impl.hpp:376</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Server__session__impl_html_a3deaeacf53a8fc63ed010394ef82c54c"><div class="ttname"><a href="classipc_1_1session_1_1Server__session__impl.html#a3deaeacf53a8fc63ed010394ef82c54c">ipc::session::Server_session_impl::client_app</a></div><div class="ttdeci">const Client_app * client_app() const</div><div class="ttdoc">See Server_session_mv counterpart.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp_source.html#l00829">server_session_impl.hpp:829</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Server__session__impl_html_a424215b95b49fea0b3b3986688395158"><div class="ttname"><a href="classipc_1_1session_1_1Server__session__impl.html#a424215b95b49fea0b3b3986688395158">ipc::session::Server_session_impl::Server_session_impl</a></div><div class="ttdeci">Server_session_impl(flow::log::Logger *logger_ptr, const Server_app &amp;srv_app_ref, transport::sync_io::Native_socket_stream &amp;&amp;master_channel_sock_stm)</div><div class="ttdoc">For use by internal user Session_server: See Server_session_mv counterpart.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp_source.html#l00681">server_session_impl.hpp:681</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Server__session__impl_html_a45a5ae92b706ea539c27be0d19a303c4"><div class="ttname"><a href="classipc_1_1session_1_1Server__session__impl.html#a45a5ae92b706ea539c27be0d19a303c4">ipc::session::Server_session_impl::open_channel</a></div><div class="ttdeci">bool open_channel(Channel_obj *target_channel, const Mdt_builder_ptr &amp;mdt, Error_code *err_code=0)</div><div class="ttdoc">See Server_session_mv counterpart.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp_source.html#l01074">server_session_impl.hpp:1074</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Server__session__impl_html_a493937b9737f1fc4803364c35ceae83e"><div class="ttname"><a href="classipc_1_1session_1_1Server__session__impl.html#a493937b9737f1fc4803364c35ceae83e">ipc::session::Server_session_impl::init_handlers</a></div><div class="ttdeci">bool init_handlers(Task_err &amp;&amp;on_err_func_arg)</div><div class="ttdoc">See Server_session_mv counterpart.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp_source.html#l00857">server_session_impl.hpp:857</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Server__session__impl_html_a54af1ca2d4e5485a2709f77d3f13635d"><div class="ttname"><a href="classipc_1_1session_1_1Server__session__impl.html#a54af1ca2d4e5485a2709f77d3f13635d">ipc::session::Server_session_impl::m_last_channel_mq_id</a></div><div class="ttdeci">unsigned int m_last_channel_mq_id</div><div class="ttdoc">Unique component of MQ names generated by make_channel_mqs() (if relevant; else untouched).</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp_source.html#l00631">server_session_impl.hpp:631</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Server__session__impl_html_a582c808f7ea2104468e56bc135172296"><div class="ttname"><a href="classipc_1_1session_1_1Server__session__impl.html#a582c808f7ea2104468e56bc135172296">ipc::session::Server_session_impl::S_SHM_TYPE</a></div><div class="ttdeci">static constexpr schema::ShmType S_SHM_TYPE</div><div class="ttdoc">See Session_mv counterpart.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp_source.html#l00228">server_session_impl.hpp:228</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Server__session__impl_html_a59236329cf8e0f75c9ef628def1b97a7"><div class="ttname"><a href="classipc_1_1session_1_1Server__session__impl.html#a59236329cf8e0f75c9ef628def1b97a7">ipc::session::Server_session_impl::m_log_in_on_done_func</a></div><div class="ttdeci">flow::async::Task_asio_err m_log_in_on_done_func</div><div class="ttdoc">The on_done_func argument to async_accept_log_in(); .empty() except while the (at most one,...</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp_source.html#l00604">server_session_impl.hpp:604</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Server__session__impl_html_a6677dde04bab0c72881848a9b72a8227"><div class="ttname"><a href="classipc_1_1session_1_1Server__session__impl.html#a6677dde04bab0c72881848a9b72a8227">ipc::session::Server_session_impl::m_last_actively_opened_channel_id</a></div><div class="ttdeci">unsigned int m_last_actively_opened_channel_id</div><div class="ttdoc">Identical to Client_session_impl::m_last_actively_opened_channel_id.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp_source.html#l00623">server_session_impl.hpp:623</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Server__session__impl_html_a6f756d12f9e2b2cc3269564ba49bb354"><div class="ttname"><a href="classipc_1_1session_1_1Server__session__impl.html#a6f756d12f9e2b2cc3269564ba49bb354">ipc::session::Server_session_impl::create_channel_and_resources</a></div><div class="ttdeci">bool create_channel_and_resources(Shared_name *mq_name_c2s_or_none_ptr, Shared_name *mq_name_s2c_or_none_ptr, util::Native_handle *remote_hndl_or_null_ptr, Channel_obj *opened_channel_ptr, bool active_else_passive)</div><div class="ttdoc">In thread W acquires the needed shared sources (MQs and/or Native_handle pair as of this writing) and...</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp_source.html#l01352">server_session_impl.hpp:1352</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Server__session__impl_html_a7134fc9c4d26ba1fbc8e5da266d970e5"><div class="ttname"><a href="classipc_1_1session_1_1Server__session__impl.html#a7134fc9c4d26ba1fbc8e5da266d970e5">ipc::session::Server_session_impl::Mdt_builder</a></div><div class="ttdeci">typename Base::Mdt_builder Mdt_builder</div><div class="ttdoc">See Server_session_mv counterpart.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp_source.html#l00211">server_session_impl.hpp:211</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Server__session__impl_html_a73419b3ccb6e3d028d8acc8f9f42e0ac"><div class="ttname"><a href="classipc_1_1session_1_1Server__session__impl.html#a73419b3ccb6e3d028d8acc8f9f42e0ac">ipc::session::Server_session_impl::m_async_worker</a></div><div class="ttdeci">flow::async::Single_thread_task_loop m_async_worker</div><div class="ttdoc">Worker thread (a/k/a thread W).</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp_source.html#l00643">server_session_impl.hpp:643</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Server__session__impl_html_a75df7061f9c57660f9fb944d83da416b"><div class="ttname"><a href="classipc_1_1session_1_1Server__session__impl.html#a75df7061f9c57660f9fb944d83da416b">ipc::session::Server_session_impl::Channels</a></div><div class="ttdeci">typename Base::Channels Channels</div><div class="ttdoc">See Session_mv counterpart.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp_source.html#l00202">server_session_impl.hpp:202</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Server__session__impl_html_a78e61f8681c7ec92fa19bae560763ab1"><div class="ttname"><a href="classipc_1_1session_1_1Server__session__impl.html#a78e61f8681c7ec92fa19bae560763ab1">ipc::session::Server_session_impl::Mdt_reader_ptr</a></div><div class="ttdeci">typename Base::Mdt_reader_ptr Mdt_reader_ptr</div><div class="ttdoc">See Server_session_mv counterpart.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp_source.html#l00208">server_session_impl.hpp:208</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Server__session__impl_html_a7c969c3a1007f8e4ba3ad1c1acd6c290"><div class="ttname"><a href="classipc_1_1session_1_1Server__session__impl.html#a7c969c3a1007f8e4ba3ad1c1acd6c290">ipc::session::Server_session_impl::Channel_obj</a></div><div class="ttdeci">typename Base::Channel_obj Channel_obj</div><div class="ttdoc">See Server_session_mv counterpart.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp_source.html#l00199">server_session_impl.hpp:199</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Server__session__impl_html_a804c629b2da8898376f071db499a2173"><div class="ttname"><a href="classipc_1_1session_1_1Server__session__impl.html#a804c629b2da8898376f071db499a2173">ipc::session::Server_session_impl::on_master_channel_open_channel_req</a></div><div class="ttdeci">void on_master_channel_open_channel_req(typename Master_structured_channel::Msg_in_ptr &amp;&amp;open_channel_req)</div><div class="ttdoc">In thread W, handler for m_master_channel receiving a passive-open (a/k/a open-channel-to-server) req...</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp_source.html#l01243">server_session_impl.hpp:1244</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Server__session__impl_html_a80daf8c8041d8d510f4712156732b09d"><div class="ttname"><a href="classipc_1_1session_1_1Server__session__impl.html#a80daf8c8041d8d510f4712156732b09d">ipc::session::Server_session_impl::Base</a></div><div class="ttdeci">Session_base&lt; S_MQ_TYPE_OR_NONE, S_TRANSMIT_NATIVE_HANDLES, Mdt_payload &gt; Base</div><div class="ttdoc">Short-hand for base type.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp_source.html#l00193">server_session_impl.hpp:193</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Server__session__impl_html_a81eb6769bc75d900bb3c442047249503"><div class="ttname"><a href="classipc_1_1session_1_1Server__session__impl.html#a81eb6769bc75d900bb3c442047249503">ipc::session::Server_session_impl::m_master_channel</a></div><div class="ttdeci">Master_structured_channel_ptr m_master_channel</div><div class="ttdoc">The session master channel.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp_source.html#l00653">server_session_impl.hpp:653</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Server__session__impl_html_a84d54a57d3e06c064cde737d1f4be472"><div class="ttname"><a href="classipc_1_1session_1_1Server__session__impl.html#a84d54a57d3e06c064cde737d1f4be472">ipc::session::Server_session_impl::make_channel_mqs</a></div><div class="ttdeci">bool make_channel_mqs(Persistent_mq_handle_from_cfg *mq_c2s, Persistent_mq_handle_from_cfg *mq_s2c, Shared_name *mq_name_c2s, Shared_name *mq_name_s2c, Error_code *err_code)</div><div class="ttdoc">Helper for create_channel_and_resources(), invoked and compiled if and only if S_MQS_ENABLED,...</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp_source.html#l01485">server_session_impl.hpp:1485</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Server__session__impl_html_a869571c6ad3555df2396d561768b3f79"><div class="ttname"><a href="classipc_1_1session_1_1Server__session__impl.html#a869571c6ad3555df2396d561768b3f79">ipc::session::Server_session_impl::m_last_passively_opened_channel_id</a></div><div class="ttdeci">unsigned int m_last_passively_opened_channel_id</div><div class="ttdoc">Identical to Client_session_impl::m_last_passively_opened_channel_id.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp_source.html#l00620">server_session_impl.hpp:620</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Server__session__impl_html_a891c082930a837694606aff30c7026ed"><div class="ttname"><a href="classipc_1_1session_1_1Server__session__impl.html#a891c082930a837694606aff30c7026ed">ipc::session::Server_session_impl::m_protocol_negotiator_aux</a></div><div class="ttdeci">transport::Protocol_negotiator m_protocol_negotiator_aux</div><div class="ttdoc">Analogous to m_protocol_negotiator but pertains to algorithms perpetuated by (if relevant) non-vanill...</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp_source.html#l00594">server_session_impl.hpp:594</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Server__session__impl_html_a9be157fe8791e7be2dd43bd06480d3eb"><div class="ttname"><a href="classipc_1_1session_1_1Server__session__impl.html#a9be157fe8791e7be2dd43bd06480d3eb">ipc::session::Server_session_impl::m_master_sock_stm</a></div><div class="ttdeci">transport::sync_io::Native_socket_stream m_master_sock_stm</div><div class="ttdoc">The pre-connected (PEER-state) socket stream peer; is non-as-if-default-cted only up to async_accept_...</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp_source.html#l00611">server_session_impl.hpp:611</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Server__session__impl_html_aa72ad11c33a4d11d5e3f0480ce0a6ff1"><div class="ttname"><a href="classipc_1_1session_1_1Server__session__impl.html#aa72ad11c33a4d11d5e3f0480ce0a6ff1">ipc::session::Server_session_impl::Persistent_mq_handle_from_cfg</a></div><div class="ttdeci">typename Base::Persistent_mq_handle_from_cfg Persistent_mq_handle_from_cfg</div><div class="ttdoc">See Session_base.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp_source.html#l00435">server_session_impl.hpp:435</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Server__session__impl_html_aa9cd0c1e6792a4ee096b55b13b4db803"><div class="ttname"><a href="classipc_1_1session_1_1Server__session__impl.html#aa9cd0c1e6792a4ee096b55b13b4db803">ipc::session::Server_session_impl::Mdt_payload_obj</a></div><div class="ttdeci">typename Base::Mdt_payload_obj Mdt_payload_obj</div><div class="ttdoc">See Server_session_mv counterpart.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp_source.html#l00205">server_session_impl.hpp:205</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Server__session__impl_html_aaa570a2ceb242370eeccca85d806fbbf"><div class="ttname"><a href="classipc_1_1session_1_1Server__session__impl.html#aaa570a2ceb242370eeccca85d806fbbf">ipc::session::Server_session_impl::master_channel_const</a></div><div class="ttdeci">const Master_structured_channel &amp; master_channel_const() const</div><div class="ttdoc">Analogous to Client_session_impl::master_channel_const().</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp_source.html#l02201">server_session_impl.hpp:2201</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Server__session__impl_html_ab6cfad1c0be9815dc5411cd20c131213"><div class="ttname"><a href="classipc_1_1session_1_1Server__session__impl.html#ab6cfad1c0be9815dc5411cd20c131213">ipc::session::Server_session_impl::Master_structured_channel_ptr</a></div><div class="ttdeci">typename Base::Master_structured_channel_ptr Master_structured_channel_ptr</div><div class="ttdoc">See Session_base.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp_source.html#l00441">server_session_impl.hpp:441</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Server__session__impl_html_ab8612a76df11f9db0d4f335848cda822"><div class="ttname"><a href="classipc_1_1session_1_1Server__session__impl.html#ab8612a76df11f9db0d4f335848cda822">ipc::session::Server_session_impl::Structured_msg_reader_config</a></div><div class="ttdeci">typename Base::Structured_msg_reader_config Structured_msg_reader_config</div><div class="ttdoc">See Session_mv counterpart.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp_source.html#l00220">server_session_impl.hpp:220</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Server__session__impl_html_abfa7d61030e1d40cdc0085afacb43b6c"><div class="ttname"><a href="classipc_1_1session_1_1Server__session__impl.html#abfa7d61030e1d40cdc0085afacb43b6c">ipc::session::Server_session_impl::S_SOCKET_STREAM_ENABLED</a></div><div class="ttdeci">static constexpr bool S_SOCKET_STREAM_ENABLED</div><div class="ttdoc">See Server_session_mv counterpart.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp_source.html#l00240">server_session_impl.hpp:240</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Server__session__impl_html_abff6feea533de655f0cd8017d6ea3293"><div class="ttname"><a href="classipc_1_1session_1_1Server__session__impl.html#abff6feea533de655f0cd8017d6ea3293">ipc::session::Server_session_impl::Structured_msg_builder_config</a></div><div class="ttdeci">typename Base::Structured_msg_builder_config Structured_msg_builder_config</div><div class="ttdoc">See Session_mv counterpart.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp_source.html#l00217">server_session_impl.hpp:217</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Server__session__impl_html_ac473cff436bde8b069a3f0d55d9c3b51"><div class="ttname"><a href="classipc_1_1session_1_1Server__session__impl.html#ac473cff436bde8b069a3f0d55d9c3b51">ipc::session::Server_session_impl::m_graceful_finisher</a></div><div class="ttdeci">std::optional&lt; typename Base::Graceful_finisher &gt; m_graceful_finisher</div><div class="ttdoc">Null until PEER state is reached, and NULL unless compile-time S_GRACEFUL_FINISH_REQUIRED is true,...</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp_source.html#l00664">server_session_impl.hpp:664</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Server__session__impl_html_ac4bc7e38574e0495af4887d2e6226b7a"><div class="ttname"><a href="classipc_1_1session_1_1Server__session__impl.html#ac4bc7e38574e0495af4887d2e6226b7a">ipc::session::Server_session_impl::Mdt_builder_ptr</a></div><div class="ttdeci">typename Base::Mdt_builder_ptr Mdt_builder_ptr</div><div class="ttdoc">See Server_session_mv counterpart.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp_source.html#l00214">server_session_impl.hpp:214</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Server__session__impl_html_ac93040ccdaf5a261a053a8b55bd2e14e"><div class="ttname"><a href="classipc_1_1session_1_1Server__session__impl.html#ac93040ccdaf5a261a053a8b55bd2e14e">ipc::session::Server_session_impl::init_handlers</a></div><div class="ttdeci">bool init_handlers(Task_err &amp;&amp;on_err_func_arg, On_passive_open_channel_handler &amp;&amp;on_passive_open_channel_func_arg)</div><div class="ttdoc">See Server_session_mv counterpart.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp_source.html#l00837">server_session_impl.hpp:837</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Server__session__impl_html_ad39cb95f2e546cf5be927dfc295306c1"><div class="ttname"><a href="classipc_1_1session_1_1Server__session__impl.html#ad39cb95f2e546cf5be927dfc295306c1">ipc::session::Server_session_impl::init_handlers_impl</a></div><div class="ttdeci">bool init_handlers_impl(flow::async::Task_asio_err &amp;&amp;on_err_func_arg, On_passive_open_channel_func &amp;&amp;on_passive_open_channel_func_or_empty_arg)</div><div class="ttdoc">Core of both init_handlers() overloads, to be invoked in thread W.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp_source.html#l00875">server_session_impl.hpp:876</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Server__session__impl_html_ad9f6932719c1565191da73bfa4a3923f"><div class="ttname"><a href="classipc_1_1session_1_1Server__session__impl.html#ad9f6932719c1565191da73bfa4a3923f">ipc::session::Server_session_impl::m_pre_init_err_code</a></div><div class="ttdeci">Error_code m_pre_init_err_code</div><div class="ttdoc">Unused/falsy except when in almost-PEER state (past successful async_accept_log_in(),...</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp_source.html#l00617">server_session_impl.hpp:617</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Server__session__impl_html_ade0880c766185ca00d12c908c3ddd3ed"><div class="ttname"><a href="classipc_1_1session_1_1Server__session__impl.html#ade0880c766185ca00d12c908c3ddd3ed">ipc::session::Server_session_impl::Open_channel_req_ptr</a></div><div class="ttdeci">boost::shared_ptr&lt; Open_channel_req &gt; Open_channel_req_ptr</div><div class="ttdoc">Short-hand for ref-counted pointer to Open_channel_req.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp_source.html#l00472">server_session_impl.hpp:472</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Server__session__impl_html_adfb10992398b46be3b0e1ac0c8605ef4"><div class="ttname"><a href="classipc_1_1session_1_1Server__session__impl.html#adfb10992398b46be3b0e1ac0c8605ef4">ipc::session::Server_session_impl::open_channel</a></div><div class="ttdeci">bool open_channel(Channel_obj *target_channel, Error_code *err_code=0)</div><div class="ttdoc">See Server_session_mv counterpart.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp_source.html#l01236">server_session_impl.hpp:1236</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Server__session__impl_html_ae33e5c8ca6904844689e78ee764bc2da"><div class="ttname"><a href="classipc_1_1session_1_1Server__session__impl.html#ae33e5c8ca6904844689e78ee764bc2da">ipc::session::Server_session_impl::handlers_are_set</a></div><div class="ttdeci">bool handlers_are_set() const</div><div class="ttdoc">In thread W, returns whether init_handlers_impl() has yet executed.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp_source.html#l00945">server_session_impl.hpp:945</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Server__session__impl_html_aeca3e83ea5e99271ba928550ea4fb2d4"><div class="ttname"><a href="classipc_1_1session_1_1Server__session__impl.html#aeca3e83ea5e99271ba928550ea4fb2d4">ipc::session::Server_session_impl::m_protocol_negotiator</a></div><div class="ttdeci">transport::Protocol_negotiator m_protocol_negotiator</div><div class="ttdoc">Handles the protocol negotiation at the start of the pipe, as pertains to algorithms perpetuated by t...</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp_source.html#l00584">server_session_impl.hpp:584</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Server__session__impl_html_aeccf8c9a6774d25bd4274962d69fc0e9"><div class="ttname"><a href="classipc_1_1session_1_1Server__session__impl.html#aeccf8c9a6774d25bd4274962d69fc0e9">ipc::session::Server_session_impl::on_master_channel_error</a></div><div class="ttdeci">void on_master_channel_error(const Error_code &amp;err_code)</div><div class="ttdoc">In thread W, handler for m_master_channel indicating incoming-direction channel-hosing error.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp_source.html#l02109">server_session_impl.hpp:2109</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Server__session__impl_html_aee35d521d9997d48f6b5565730e60e93"><div class="ttname"><a href="classipc_1_1session_1_1Server__session__impl.html#aee35d521d9997d48f6b5565730e60e93">ipc::session::Server_session_impl::async_accept_log_in</a></div><div class="ttdeci">void async_accept_log_in(Session_server_impl_t *srv, Channels *init_channels_by_srv_req, Mdt_reader_ptr *mdt_from_cli_or_null, Channels *init_channels_by_cli_req, Cli_app_lookup_func &amp;&amp;cli_app_lookup_func, Cli_namespace_func &amp;&amp;cli_namespace_func, Pre_rsp_setup_func &amp;&amp;pre_rsp_setup_func, N_init_channels_by_srv_req_func &amp;&amp;n_init_channels_by_srv_req_func, Mdt_load_func &amp;&amp;mdt_load_func, Task_err &amp;&amp;on_done_func)</div><div class="ttdoc">For use by internal user Session_server: See Server_session_mv counterpart.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp_source.html#l01582">server_session_impl.hpp:1583</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Server__session__impl_html_af8013f82c2441d07bc82eda7cc3ad835"><div class="ttname"><a href="classipc_1_1session_1_1Server__session__impl.html#af8013f82c2441d07bc82eda7cc3ad835">ipc::session::Server_session_impl::On_passive_open_channel_func</a></div><div class="ttdeci">typename Base::On_passive_open_channel_func On_passive_open_channel_func</div><div class="ttdoc">See Session_base.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp_source.html#l00438">server_session_impl.hpp:438</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Session__base_1_1Graceful__finisher_html"><div class="ttname"><a href="classipc_1_1session_1_1Session__base_1_1Graceful__finisher.html">ipc::session::Session_base::Graceful_finisher</a></div><div class="ttdoc">Optional to use by subclasses, this operates a simple state machine that carries out a graceful-sessi...</div><div class="ttdef"><b>Definition:</b> <a href="session__base_8hpp_source.html#l00575">session_base.hpp:578</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Session__base_1_1Graceful__finisher_html_af441f45ce1ed7b890c3ab77d959f8830"><div class="ttname"><a href="classipc_1_1session_1_1Session__base_1_1Graceful__finisher.html#af441f45ce1ed7b890c3ab77d959f8830">ipc::session::Session_base::Graceful_finisher::on_dtor_start</a></div><div class="ttdeci">void on_dtor_start()</div><div class="ttdoc">The reason Graceful_finisher exists, this method must be called at the start of *_session_impl dtor; ...</div><div class="ttdef"><b>Definition:</b> <a href="session__base_8hpp_source.html#l01126">session_base.hpp:1126</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Session__base_html"><div class="ttname"><a href="classipc_1_1session_1_1Session__base.html">ipc::session::Session_base</a></div><div class="ttdoc">Internal type containing data and types common to internal types Server_session_impl and Client_sessi...</div><div class="ttdef"><b>Definition:</b> <a href="session__base_8hpp_source.html#l00067">session_base.hpp:69</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Session__base_html_a1f7c4243c8bd55930f51a568884c8aaf"><div class="ttname"><a href="classipc_1_1session_1_1Session__base.html#a1f7c4243c8bd55930f51a568884c8aaf">ipc::session::Session_base::S_SOCKET_STREAM_ENABLED</a></div><div class="ttdeci">static constexpr bool S_SOCKET_STREAM_ENABLED</div><div class="ttdoc">See Session_mv.</div><div class="ttdef"><b>Definition:</b> <a href="session__base_8hpp_source.html#l00077">session_base.hpp:77</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Session__base_html_a26d038e14e3c0e461e76de88c4ce76c5"><div class="ttname"><a href="classipc_1_1session_1_1Session__base.html#a26d038e14e3c0e461e76de88c4ce76c5">ipc::session::Session_base::Master_structured_channel</a></div><div class="ttdeci">transport::struc::Channel_via_heap&lt; transport::Socket_stream_channel&lt; true &gt;, schema::detail::SessionMasterChannelMessageBody&lt; Mdt_payload_obj &gt; &gt; Master_structured_channel</div><div class="ttdoc">The (internally used) session master channel is a transport::struc::Channel of this concrete type.</div><div class="ttdef"><b>Definition:</b> <a href="session__base_8hpp_source.html#l00352">session_base.hpp:355</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Session__base_html_a27a5731a648effb6b4b42f0312affa74"><div class="ttname"><a href="classipc_1_1session_1_1Session__base.html#a27a5731a648effb6b4b42f0312affa74">ipc::session::Session_base::S_MQS_ENABLED</a></div><div class="ttdeci">static constexpr bool S_MQS_ENABLED</div><div class="ttdoc">See Session_mv.</div><div class="ttdef"><b>Definition:</b> <a href="session__base_8hpp_source.html#l00074">session_base.hpp:74</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Session__base_html_a35234981ca87cc2f6b118b3e52452ea8"><div class="ttname"><a href="classipc_1_1session_1_1Session__base.html#a35234981ca87cc2f6b118b3e52452ea8">ipc::session::Session_base::Mdt_payload_obj</a></div><div class="ttdeci">Mdt_payload Mdt_payload_obj</div><div class="ttdoc">See Session_mv (or Session concept).</div><div class="ttdef"><b>Definition:</b> <a href="session__base_8hpp_source.html#l00125">session_base.hpp:125</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Session__base_html_a3c0824a54ef32915c5c5ea76481f2409"><div class="ttname"><a href="classipc_1_1session_1_1Session__base.html#a3c0824a54ef32915c5c5ea76481f2409">ipc::session::Session_base::On_passive_open_channel_func</a></div><div class="ttdeci">Function&lt; void(Channel_obj &amp;&amp;new_channel, Mdt_reader_ptr &amp;&amp;new_channel_mdt)&gt; On_passive_open_channel_func</div><div class="ttdoc">Concrete function type for the on-passive-open handler (if any), used for storage.</div><div class="ttdef"><b>Definition:</b> <a href="session__base_8hpp_source.html#l00372">session_base.hpp:373</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Session__base_html_a4a7a5b83f6ba8bd505685636eabc012b"><div class="ttname"><a href="classipc_1_1session_1_1Session__base.html#a4a7a5b83f6ba8bd505685636eabc012b">ipc::session::Session_base::Mdt_builder_ptr</a></div><div class="ttdeci">boost::shared_ptr&lt; Mdt_builder &gt; Mdt_builder_ptr</div><div class="ttdoc">See Session_mv (or Session concept).</div><div class="ttdef"><b>Definition:</b> <a href="session__base_8hpp_source.html#l00136">session_base.hpp:136</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Session__base_html_a638232ef74a0eb80aeb4f027ee06f9bf"><div class="ttname"><a href="classipc_1_1session_1_1Session__base.html#a638232ef74a0eb80aeb4f027ee06f9bf">ipc::session::Session_base::Channels</a></div><div class="ttdeci">std::vector&lt; Channel_obj &gt; Channels</div><div class="ttdoc">See Session_mv. Note: If changed from vector please update those doc headers too.</div><div class="ttdef"><b>Definition:</b> <a href="session__base_8hpp_source.html#l00122">session_base.hpp:122</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Session__base_html_a71f02a809d667c23ff8af29a96940bd1"><div class="ttname"><a href="classipc_1_1session_1_1Session__base.html#a71f02a809d667c23ff8af29a96940bd1">ipc::session::Session_base::Channel_obj</a></div><div class="ttdeci">std::conditional_t&lt; S_MQS_ENABLED, std::conditional_t&lt; S_TRANSMIT_NATIVE_HANDLES, transport::Mqs_socket_stream_channel&lt; true, Persistent_mq_handle_from_cfg &gt;, transport::Mqs_channel&lt; true, Persistent_mq_handle_from_cfg &gt; &gt;, std::conditional_t&lt; S_TRANSMIT_NATIVE_HANDLES, transport::Socket_stream_channel&lt; true &gt;, transport::Socket_stream_channel_of_blobs&lt; true &gt; &gt; &gt; Channel_obj</div><div class="ttdoc">See Session_mv (or Session concept).</div><div class="ttdef"><b>Definition:</b> <a href="session__base_8hpp_source.html#l00111">session_base.hpp:119</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Session__base_html_a7d68bbb8c0c09983619d563bca30bd45"><div class="ttname"><a href="classipc_1_1session_1_1Session__base.html#a7d68bbb8c0c09983619d563bca30bd45">ipc::session::Session_base::Mdt_builder</a></div><div class="ttdeci">typename transport::struc::schema::Metadata&lt; Mdt_payload_obj &gt;::Builder Mdt_builder</div><div class="ttdoc">See Session_mv (or Session concept).</div><div class="ttdef"><b>Definition:</b> <a href="session__base_8hpp_source.html#l00132">session_base.hpp:133</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Session__base_html_a848c0f5247644ada0f8b0ab816eedda8"><div class="ttname"><a href="classipc_1_1session_1_1Session__base.html#a848c0f5247644ada0f8b0ab816eedda8">ipc::session::Session_base::Persistent_mq_handle_from_cfg</a></div><div class="ttdeci">std::conditional_t&lt;!S_MQS_ENABLED, transport::Null_peer, std::conditional_t&lt; S_MQ_TYPE_OR_NONE==schema::MqType::POSIX, transport::Posix_mq_handle, transport::Bipc_mq_handle &gt; &gt; Persistent_mq_handle_from_cfg</div><div class="ttdoc">Relevant only if S_MQS_ENABLED, this is the Persistent_mq_handle-concept impl type specified by the u...</div><div class="ttdef"><b>Definition:</b> <a href="session__base_8hpp_source.html#l00103">session_base.hpp:108</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Session__base_html_abd854f2b9316361ef18f15610c242d4b"><div class="ttname"><a href="classipc_1_1session_1_1Session__base.html#abd854f2b9316361ef18f15610c242d4b">ipc::session::Session_base::Structured_msg_reader_config</a></div><div class="ttdeci">transport::struc::Heap_reader::Config Structured_msg_reader_config</div><div class="ttdoc">See Session_mv (or Session concept).</div><div class="ttdef"><b>Definition:</b> <a href="session__base_8hpp_source.html#l00142">session_base.hpp:142</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Session__base_html_ace4dab42adec6354cc66081dd218ac71"><div class="ttname"><a href="classipc_1_1session_1_1Session__base.html#ace4dab42adec6354cc66081dd218ac71">ipc::session::Session_base::Mdt_reader_ptr</a></div><div class="ttdeci">boost::shared_ptr&lt; typename transport::struc::schema::Metadata&lt; Mdt_payload_obj &gt;::Reader &gt; Mdt_reader_ptr</div><div class="ttdoc">See Session_mv (or Session concept).</div><div class="ttdef"><b>Definition:</b> <a href="session__base_8hpp_source.html#l00128">session_base.hpp:129</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Session__base_html_aee0db48505c84d3553b7110a9a815036"><div class="ttname"><a href="classipc_1_1session_1_1Session__base.html#aee0db48505c84d3553b7110a9a815036">ipc::session::Session_base::Structured_msg_builder_config</a></div><div class="ttdeci">transport::struc::Heap_fixed_builder::Config Structured_msg_builder_config</div><div class="ttdoc">See Session_mv (or Session concept).</div><div class="ttdef"><b>Definition:</b> <a href="session__base_8hpp_source.html#l00139">session_base.hpp:139</a></div></div>
<div class="ttc" id="aclassipc_1_1session_1_1Session__base_html_af0ca2a01d7d0d92038aae56fc1cdd505"><div class="ttname"><a href="classipc_1_1session_1_1Session__base.html#af0ca2a01d7d0d92038aae56fc1cdd505">ipc::session::Session_base::Master_structured_channel_ptr</a></div><div class="ttdeci">boost::shared_ptr&lt; Master_structured_channel &gt; Master_structured_channel_ptr</div><div class="ttdoc">Handle to Master_structured_channel.</div><div class="ttdef"><b>Definition:</b> <a href="session__base_8hpp_source.html#l00366">session_base.hpp:366</a></div></div>
<div class="ttc" id="aclassipc_1_1transport_1_1Mqs__channel_html"><div class="ttname"><a href="classipc_1_1transport_1_1Mqs__channel.html">ipc::transport::Mqs_channel</a></div><div class="ttdoc">A Channel with at least a blobs pipe consisting of two MQs of type Persistent_mq_handle (template arg...</div><div class="ttdef"><b>Definition:</b> <a href="ipc__core_2src_2ipc_2transport_2channel_8hpp_source.html#l01174">channel.hpp:1180</a></div></div>
<div class="ttc" id="aclassipc_1_1transport_1_1Mqs__socket__stream__channel_html"><div class="ttname"><a href="classipc_1_1transport_1_1Mqs__socket__stream__channel.html">ipc::transport::Mqs_socket_stream_channel</a></div><div class="ttdoc">A Channel with a blobs pipe consisting of 2 MQs of type Persistent_mq_handle (template arg); and a ha...</div><div class="ttdef"><b>Definition:</b> <a href="ipc__core_2src_2ipc_2transport_2channel_8hpp_source.html#l01273">channel.hpp:1278</a></div></div>
<div class="ttc" id="aclassipc_1_1transport_1_1Protocol__negotiator_html"><div class="ttname"><a href="classipc_1_1transport_1_1Protocol__negotiator.html">ipc::transport::Protocol_negotiator</a></div><div class="ttdoc">A simple state machine that, assuming the opposide side of a comm pathway uses an equivalent state ma...</div><div class="ttdef"><b>Definition:</b> <a href="protocol__negotiator_8hpp_source.html#l00189">protocol_negotiator.hpp:191</a></div></div>
<div class="ttc" id="aclassipc_1_1transport_1_1Socket__stream__channel__of__blobs_html"><div class="ttname"><a href="classipc_1_1transport_1_1Socket__stream__channel__of__blobs.html">ipc::transport::Socket_stream_channel_of_blobs</a></div><div class="ttdoc">A Channel with a blobs pipe only (no handles pipe) that uses a Unix domain socket connection as the u...</div><div class="ttdef"><b>Definition:</b> <a href="ipc__core_2src_2ipc_2transport_2channel_8hpp_source.html#l01093">channel.hpp:1097</a></div></div>
<div class="ttc" id="aclassipc_1_1transport_1_1Socket__stream__channel_html"><div class="ttname"><a href="classipc_1_1transport_1_1Socket__stream__channel.html">ipc::transport::Socket_stream_channel</a></div><div class="ttdoc">A Channel with a handles pipe only (no blobs pipe) that uses a Unix domain socket connection as the u...</div><div class="ttdef"><b>Definition:</b> <a href="ipc__core_2src_2ipc_2transport_2channel_8hpp_source.html#l01025">channel.hpp:1029</a></div></div>
<div class="ttc" id="aclassipc_1_1transport_1_1Socket__stream__channel_html_acad7936d9a7db817bc46ee4fe479d838"><div class="ttname"><a href="classipc_1_1transport_1_1Socket__stream__channel.html#acad7936d9a7db817bc46ee4fe479d838">ipc::transport::Socket_stream_channel::remote_peer_process_credentials</a></div><div class="ttdeci">util::Process_credentials remote_peer_process_credentials(Error_code *err_code=0) const</div><div class="ttdoc">Identical to Native_socket_stream::remote_peer_process_credentials(): OS-reported process credential ...</div><div class="ttdef"><b>Definition:</b> <a href="ipc__core_2src_2ipc_2transport_2channel_8hpp_source.html#l02211">channel.hpp:2211</a></div></div>
<div class="ttc" id="aclassipc_1_1transport_1_1struc_1_1Channel__base_html_ab0eb05b5fb52364c99868a8535aaf26e"><div class="ttname"><a href="classipc_1_1transport_1_1struc_1_1Channel__base.html#ab0eb05b5fb52364c99868a8535aaf26e">ipc::transport::struc::Channel_base::S_SERIALIZE_VIA_HEAP</a></div><div class="ttdeci">static constexpr Serialize_via_heap S_SERIALIZE_VIA_HEAP</div><div class="ttdoc">The sole value of the tag type Serialize_via_heap.</div><div class="ttdef"><b>Definition:</b> <a href="channel__base_8hpp_source.html#l00157">channel_base.hpp:157</a></div></div>
<div class="ttc" id="aclassipc_1_1transport_1_1struc_1_1Channel_html"><div class="ttname"><a href="classipc_1_1transport_1_1struc_1_1Channel.html">ipc::transport::struc::Channel</a></div><div class="ttdoc">Owning and wrapping a pre-connected transport::Channel peer (an endpoint of an established channel ov...</div><div class="ttdef"><b>Definition:</b> <a href="ipc__transport__structured_2src_2ipc_2transport_2struc_2channel_8hpp_source.html#l00586">channel.hpp:589</a></div></div>
<div class="ttc" id="aclassipc_1_1transport_1_1struc_1_1Channel_html_ae1f4b316eaeb7ed520a84d9e21e21063"><div class="ttname"><a href="classipc_1_1transport_1_1struc_1_1Channel.html#ae1f4b316eaeb7ed520a84d9e21e21063">ipc::transport::struc::Channel::Msg_in_ptr</a></div><div class="ttdeci">typename Sync_io_obj::Msg_in_ptr Msg_in_ptr</div><div class="ttdoc">A ref-counted handle to Msg_in.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__transport__structured_2src_2ipc_2transport_2struc_2channel_8hpp_source.html#l00646">channel.hpp:646</a></div></div>
<div class="ttc" id="aclassipc_1_1transport_1_1sync__io_1_1Native__socket__stream_html"><div class="ttname"><a href="classipc_1_1transport_1_1sync__io_1_1Native__socket__stream.html">ipc::transport::sync_io::Native_socket_stream</a></div><div class="ttdoc">Implements both sync_io::Native_handle_sender and sync_io::Native_handle_receiver concepts by using a...</div><div class="ttdef"><b>Definition:</b> <a href="sync__io_2native__socket__stream_8hpp_source.html#l00150">native_socket_stream.hpp:151</a></div></div>
<div class="ttc" id="aclassipc_1_1util_1_1Process__credentials_html"><div class="ttname"><a href="classipc_1_1util_1_1Process__credentials.html">ipc::util::Process_credentials</a></div><div class="ttdoc">A process's credentials (PID, UID, GID as of this writing).</div><div class="ttdef"><b>Definition:</b> <a href="process__credentials_8hpp_source.html#l00038">process_credentials.hpp:39</a></div></div>
<div class="ttc" id="aclassipc_1_1util_1_1Shared__name_html"><div class="ttname"><a href="classipc_1_1util_1_1Shared__name.html">ipc::util::Shared_name</a></div><div class="ttdoc">String-wrapping abstraction representing a name uniquely distinguishing a kernel-persistent entity fr...</div><div class="ttdef"><b>Definition:</b> <a href="shared__name_8hpp_source.html#l00241">shared_name.hpp:242</a></div></div>
<div class="ttc" id="aclassipc_1_1util_1_1Shared__name_html_a48f20b7b54490aa10dc64081d34c55b2"><div class="ttname"><a href="classipc_1_1util_1_1Shared__name.html#a48f20b7b54490aa10dc64081d34c55b2">ipc::util::Shared_name::ct</a></div><div class="ttdeci">static Shared_name ct(const Source &amp;src)</div><div class="ttdoc">Copy-constructs from a char-sequence container (including string, util::String_view,...</div><div class="ttdef"><b>Definition:</b> <a href="shared__name_8hpp_source.html#l00674">shared_name.hpp:674</a></div></div>
<div class="ttc" id="aclassipc_1_1util_1_1Shared__name_html_a861ea6c9ad6672e83bab5c7747b66f7b"><div class="ttname"><a href="classipc_1_1util_1_1Shared__name.html#a861ea6c9ad6672e83bab5c7747b66f7b">ipc::util::Shared_name::empty</a></div><div class="ttdeci">bool empty() const</div><div class="ttdoc">Returns true if and only if str().empty() == true.</div><div class="ttdef"><b>Definition:</b> <a href="shared__name_8cpp_source.html#l00155">shared_name.cpp:155</a></div></div>
<div class="ttc" id="aclassipc_1_1util_1_1Shared__name_html_ae89e1e061f87ffe0288514e254837595"><div class="ttname"><a href="classipc_1_1util_1_1Shared__name.html#ae89e1e061f87ffe0288514e254837595">ipc::util::Shared_name::str</a></div><div class="ttdeci">const std::string &amp; str() const</div><div class="ttdoc">Returns (sans copying) ref to immutable entire wrapped name string, suitable to pass into sys calls w...</div><div class="ttdef"><b>Definition:</b> <a href="shared__name_8cpp_source.html#l00140">shared_name.cpp:140</a></div></div>
<div class="ttc" id="aipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp_html_a97654d0122c90a30b35a270e840ad9b7"><div class="ttname"><a href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp.html#a97654d0122c90a30b35a270e840ad9b7">CLASS_SRV_SESSION_IMPL</a></div><div class="ttdeci">#define CLASS_SRV_SESSION_IMPL</div><div class="ttdoc">Internally used macro; public API users should disregard (same deal as in struc/channel....</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp_source.html#l00676">server_session_impl.hpp:676</a></div></div>
<div class="ttc" id="aipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp_html_aea842eaa966995a5ff8abf5672a25a5f"><div class="ttname"><a href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp.html#aea842eaa966995a5ff8abf5672a25a5f">TEMPLATE_SRV_SESSION_IMPL</a></div><div class="ttdeci">#define TEMPLATE_SRV_SESSION_IMPL</div><div class="ttdoc">Internally used macro; public API users should disregard (same deal as in struc/channel....</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp_source.html#l00672">server_session_impl.hpp:672</a></div></div>
<div class="ttc" id="aipc__session_2src_2ipc_2session_2error_8hpp_html"><div class="ttname"><a href="ipc__session_2src_2ipc_2session_2error_8hpp.html">error.hpp</a></div></div>
<div class="ttc" id="anamespaceipc_1_1session_1_1error_html_a0708d4bec9ae853f4d7e3d7822fc8f2fa10d32cf1382fb003f09a6df2da408574"><div class="ttname"><a href="namespaceipc_1_1session_1_1error.html#a0708d4bec9ae853f4d7e3d7822fc8f2fa10d32cf1382fb003f09a6df2da408574">ipc::session::error::Code::S_SESSION_OPEN_CHANNEL_SERVER_CANNOT_PROCEED_RESOURCE_UNAVAILABLE</a></div><div class="ttdeci">@ S_SESSION_OPEN_CHANNEL_SERVER_CANNOT_PROCEED_RESOURCE_UNAVAILABLE</div><div class="ttdoc">Session channel opening: Server peer is responsible for low-level resource acquisition but failed to ...</div></div>
<div class="ttc" id="anamespaceipc_1_1session_1_1error_html_a0708d4bec9ae853f4d7e3d7822fc8f2fa2c8c27c65ff6234220a84f96de8a1870"><div class="ttname"><a href="namespaceipc_1_1session_1_1error.html#a0708d4bec9ae853f4d7e3d7822fc8f2fa2c8c27c65ff6234220a84f96de8a1870">ipc::session::error::Code::S_SESSION_OPEN_CHANNEL_REMOTE_PEER_REJECTED_PASSIVE_OPEN</a></div><div class="ttdeci">@ S_SESSION_OPEN_CHANNEL_REMOTE_PEER_REJECTED_PASSIVE_OPEN</div><div class="ttdoc">Session channel opening: User code chose to reject all passive-open requests.</div></div>
<div class="ttc" id="anamespaceipc_1_1session_1_1error_html_a0708d4bec9ae853f4d7e3d7822fc8f2fa3f305ed5a242f067c9116216c0674264"><div class="ttname"><a href="namespaceipc_1_1session_1_1error.html#a0708d4bec9ae853f4d7e3d7822fc8f2fa3f305ed5a242f067c9116216c0674264">ipc::session::error::Code::S_SERVER_MASTER_LOG_IN_REQUEST_CLIENT_APP_INCONSISTENT_CREDS</a></div><div class="ttdeci">@ S_SERVER_MASTER_LOG_IN_REQUEST_CLIENT_APP_INCONSISTENT_CREDS</div><div class="ttdoc">Session master channel: log-in as server: client application-level process credentials (UID,...</div></div>
<div class="ttc" id="anamespaceipc_1_1session_1_1error_html_a0708d4bec9ae853f4d7e3d7822fc8f2fa7d85b87223a9b277b8875c1f7971d6ad"><div class="ttname"><a href="namespaceipc_1_1session_1_1error.html#a0708d4bec9ae853f4d7e3d7822fc8f2fa7d85b87223a9b277b8875c1f7971d6ad">ipc::session::error::Code::S_SESSION_OPEN_CHANNEL_ACTIVE_TIMEOUT</a></div><div class="ttdeci">@ S_SESSION_OPEN_CHANNEL_ACTIVE_TIMEOUT</div><div class="ttdoc">Session channel opening: Other peer must reply quickly enough as-if non-blocking but did not do so in...</div></div>
<div class="ttc" id="anamespaceipc_1_1session_1_1error_html_a0708d4bec9ae853f4d7e3d7822fc8f2faa195e468548ba9602c27590f2d6d49f0"><div class="ttname"><a href="namespaceipc_1_1session_1_1error.html#a0708d4bec9ae853f4d7e3d7822fc8f2faa195e468548ba9602c27590f2d6d49f0">ipc::session::error::Code::S_SERVER_MASTER_LOG_IN_REQUEST_CLIENT_APP_DISALLOWED_OR_UNKNOWN</a></div><div class="ttdeci">@ S_SERVER_MASTER_LOG_IN_REQUEST_CLIENT_APP_DISALLOWED_OR_UNKNOWN</div><div class="ttdoc">Session master channel: log-in as server: client identifies self as unknown client-app or one that is...</div></div>
<div class="ttc" id="anamespaceipc_1_1session_1_1error_html_a0708d4bec9ae853f4d7e3d7822fc8f2fac416e988563e44bf15fc6a81743eef53"><div class="ttname"><a href="namespaceipc_1_1session_1_1error.html#a0708d4bec9ae853f4d7e3d7822fc8f2fac416e988563e44bf15fc6a81743eef53">ipc::session::error::Code::S_INVALID_ARGUMENT</a></div><div class="ttdeci">@ S_INVALID_ARGUMENT</div><div class="ttdoc">User called an API with 1 or more arguments against the API spec.</div></div>
<div class="ttc" id="anamespaceipc_1_1session_1_1error_html_a0708d4bec9ae853f4d7e3d7822fc8f2fac734bd48bbfe30867f627363a8d5afc4"><div class="ttname"><a href="namespaceipc_1_1session_1_1error.html#a0708d4bec9ae853f4d7e3d7822fc8f2fac734bd48bbfe30867f627363a8d5afc4">ipc::session::error::Code::S_SERVER_MASTER_LOG_IN_REQUEST_CONFIG_MISMATCH</a></div><div class="ttdeci">@ S_SERVER_MASTER_LOG_IN_REQUEST_CONFIG_MISMATCH</div><div class="ttdoc">Session master channel: log-in as server: opposing client's compile-time type config differs from loc...</div></div>
<div class="ttc" id="anamespaceipc_1_1session_1_1error_html_a0708d4bec9ae853f4d7e3d7822fc8f2fafe29343445a7bf167cc186a44bd2c6ed"><div class="ttname"><a href="namespaceipc_1_1session_1_1error.html#a0708d4bec9ae853f4d7e3d7822fc8f2fafe29343445a7bf167cc186a44bd2c6ed">ipc::session::error::Code::S_OBJECT_SHUTDOWN_ABORTED_COMPLETION_HANDLER</a></div><div class="ttdeci">@ S_OBJECT_SHUTDOWN_ABORTED_COMPLETION_HANDLER</div><div class="ttdoc">Async completion handler is being called prematurely, because underlying object is shutting down,...</div></div>
<div class="ttc" id="anamespaceipc_1_1session_html"><div class="ttname"><a href="namespaceipc_1_1session.html">ipc::session</a></div><div class="ttdoc">Flow-IPC module providing the broad lifecycle and shared-resource organization – via the session conc...</div><div class="ttdef"><b>Definition:</b> <a href="app_8cpp_source.html#l00026">app.cpp:27</a></div></div>
<div class="ttc" id="anamespaceipc_1_1session_html_a365d2d63f77b738e67e206af6b702634"><div class="ttname"><a href="namespaceipc_1_1session.html#a365d2d63f77b738e67e206af6b702634">ipc::session::build_conventional_shared_name</a></div><div class="ttdeci">Shared_name build_conventional_shared_name(const Shared_name &amp;resource_type, const Shared_name &amp;srv_app_name, const Shared_name &amp;srv_namespace, const Shared_name &amp;cli_app_name, const Shared_name &amp;cli_namespace_or_sentinel)</div><div class="ttdoc">Builds an absolute name according to the path convention explained in Shared_name class doc header; t...</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2session__shared__name_8cpp_source.html#l00043">session_shared_name.cpp:44</a></div></div>
<div class="ttc" id="anamespaceipc_1_1session_html_a6b2f9a90ac9cc5098d9b90e7f547c97e"><div class="ttname"><a href="namespaceipc_1_1session.html#a6b2f9a90ac9cc5098d9b90e7f547c97e">ipc::session::operator&lt;&lt;</a></div><div class="ttdeci">std::ostream &amp; operator&lt;&lt;(std::ostream &amp;os, const App &amp;val)</div><div class="ttdoc">Prints string representation of the given App to the given ostream.</div><div class="ttdef"><b>Definition:</b> <a href="app_8cpp_source.html#l00124">app.cpp:124</a></div></div>
<div class="ttc" id="anamespaceipc_1_1session_html_ade2b302f1a3623e8adc9694568d94d2c"><div class="ttname"><a href="namespaceipc_1_1session.html#ade2b302f1a3623e8adc9694568d94d2c">ipc::session::Session_token</a></div><div class="ttdeci">transport::struc::Session_token Session_token</div><div class="ttdoc">Convenience alias for the commonly used type transport::struc::Session_token.</div><div class="ttdef"><b>Definition:</b> <a href="session__fwd_8hpp_source.html#l00248">session_fwd.hpp:248</a></div></div>
<div class="ttc" id="anamespaceipc_1_1transport_1_1asio__local__stream__socket_html_a1788f9dbd896bb71b3693f9ae25b40ae"><div class="ttname"><a href="namespaceipc_1_1transport_1_1asio__local__stream__socket.html#a1788f9dbd896bb71b3693f9ae25b40ae">ipc::transport::asio_local_stream_socket::Peer_socket</a></div><div class="ttdeci">Protocol::socket Peer_socket</div><div class="ttdoc">Short-hand for boost.asio Unix domain peer stream-socket (usually-connected-or-empty guy).</div><div class="ttdef"><b>Definition:</b> <a href="asio__local__stream__socket__fwd_8hpp_source.html#l00114">asio_local_stream_socket_fwd.hpp:114</a></div></div>
<div class="ttc" id="anamespaceipc_1_1transport_1_1error_html_adfef15ef4e76cc55d652fbd9c2797297abcfca4c2347f9d377dd2ac41c41dc027"><div class="ttname"><a href="namespaceipc_1_1transport_1_1error.html#adfef15ef4e76cc55d652fbd9c2797297abcfca4c2347f9d377dd2ac41c41dc027">ipc::transport::error::Code::S_TIMEOUT</a></div><div class="ttdeci">@ S_TIMEOUT</div><div class="ttdoc">A (usually user-specified) timeout period has elapsed before a blocking operation completed.</div></div>
<div class="ttc" id="anamespaceipc_1_1transport_1_1struc_html_ad556d20a2aa2d52b83c7afb73951d47d"><div class="ttname"><a href="namespaceipc_1_1transport_1_1struc.html#ad556d20a2aa2d52b83c7afb73951d47d">ipc::transport::struc::NULL_SESSION_TOKEN</a></div><div class="ttdeci">const Session_token NULL_SESSION_TOKEN</div><div class="ttdoc">A value for which .is_nil() is true.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__transport__structured_2src_2ipc_2transport_2struc_2channel_8cpp_source.html#l00035">channel.cpp:35</a></div></div>
<div class="ttc" id="anamespaceipc_1_1transport_html_a7ee4551983d9df16ec16a3139bac50e8"><div class="ttname"><a href="namespaceipc_1_1transport.html#a7ee4551983d9df16ec16a3139bac50e8">ipc::transport::Native_handle</a></div><div class="ttdeci">util::Native_handle Native_handle</div><div class="ttdoc">Convenience alias for the commonly used type util::Native_handle.</div><div class="ttdef"><b>Definition:</b> <a href="transport__fwd_8hpp_source.html#l00081">transport_fwd.hpp:81</a></div></div>
<div class="ttc" id="anamespaceipc_1_1util_html_a31e67d3a017477a04b313927e2f2c733"><div class="ttname"><a href="namespaceipc_1_1util.html#a31e67d3a017477a04b313927e2f2c733">ipc::util::Task</a></div><div class="ttdeci">flow::async::Task Task</div><div class="ttdoc">Short-hand for polymorphic function (a-la std::function&lt;&gt;) that takes no arguments and returns nothin...</div><div class="ttdef"><b>Definition:</b> <a href="util__fwd_8hpp_source.html#l00122">util_fwd.hpp:122</a></div></div>
<div class="ttc" id="anamespaceipc_1_1util_html_abda2ce5bcdbc26ca63d667b87818439c"><div class="ttname"><a href="namespaceipc_1_1util.html#abda2ce5bcdbc26ca63d667b87818439c">ipc::util::shared_resource_permissions</a></div><div class="ttdeci">Permissions shared_resource_permissions(Permissions_level permissions_lvl)</div><div class="ttdoc">Maps general Permissions_level specifier to low-level Permissions value, when the underlying resource...</div><div class="ttdef"><b>Definition:</b> <a href="ipc__core_2src_2ipc_2util_2util_8cpp_source.html#l00037">util.cpp:37</a></div></div>
<div class="ttc" id="anamespaceipc_1_1util_html_ad1ca1cab79a35e1eb1c47037a0973cd8"><div class="ttname"><a href="namespaceipc_1_1util.html#ad1ca1cab79a35e1eb1c47037a0973cd8">ipc::util::CREATE_ONLY</a></div><div class="ttdeci">const Create_only CREATE_ONLY</div><div class="ttdoc">Tag value indicating an atomic create-unless-exists-else-fail operation.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__core_2src_2ipc_2util_2util_8cpp_source.html#l00032">util.cpp:32</a></div></div>
<div class="ttc" id="anamespaceipc_html_a4ccdeed058222c635745a4dc830e99f7"><div class="ttname"><a href="namespaceipc.html#a4ccdeed058222c635745a4dc830e99f7">ipc::Log_component</a></div><div class="ttdeci">Log_component</div><div class="ttdoc">The flow::log::Component payload enumeration containing various log components used by Flow-IPC inter...</div><div class="ttdef"><b>Definition:</b> <a href="common_8hpp_source.html#l00322">common.hpp:323</a></div></div>
<div class="ttc" id="anamespaceipc_html_aa3192e586cc45d3e7c22463bf2760f89"><div class="ttname"><a href="namespaceipc.html#aa3192e586cc45d3e7c22463bf2760f89">ipc::Error_code</a></div><div class="ttdeci">flow::Error_code Error_code</div><div class="ttdoc">Short-hand for flow::Error_code which is very common.</div><div class="ttdef"><b>Definition:</b> <a href="common_8hpp_source.html#l00298">common.hpp:298</a></div></div>
<div class="ttc" id="anamespaceipc_html_aa455c7f045059736578ca275fc1a851f"><div class="ttname"><a href="namespaceipc.html#aa455c7f045059736578ca275fc1a851f">ipc::Function</a></div><div class="ttdeci">flow::Function&lt; Signature &gt; Function</div><div class="ttdoc">Short-hand for polymorphic functor holder which is very common. This is essentially std::function.</div><div class="ttdef"><b>Definition:</b> <a href="common_8hpp_source.html#l00302">common.hpp:302</a></div></div>
<div class="ttc" id="aprotocol__negotiator_8hpp_html"><div class="ttname"><a href="protocol__negotiator_8hpp.html">protocol_negotiator.hpp</a></div></div>
<div class="ttc" id="asession__base_8hpp_html"><div class="ttname"><a href="session__base_8hpp.html">session_base.hpp</a></div></div>
<div class="ttc" id="astructipc_1_1session_1_1Client__app_html"><div class="ttname"><a href="structipc_1_1session_1_1Client__app.html">ipc::session::Client_app</a></div><div class="ttdoc">An App that is used as a client in at least one client-server IPC split.</div><div class="ttdef"><b>Definition:</b> <a href="app_8hpp_source.html#l00184">app.hpp:185</a></div></div>
<div class="ttc" id="astructipc_1_1session_1_1Server__app_html"><div class="ttname"><a href="structipc_1_1session_1_1Server__app.html">ipc::session::Server_app</a></div><div class="ttdoc">An App that is used as a server in at least one client-server IPC split.</div><div class="ttdef"><b>Definition:</b> <a href="app_8hpp_source.html#l00205">app.hpp:206</a></div></div>
<div class="ttc" id="astructipc_1_1session_1_1Server__session__impl_1_1Open__channel__req_html"><div class="ttname"><a href="structipc_1_1session_1_1Server__session__impl_1_1Open__channel__req.html">ipc::session::Server_session_impl::Open_channel_req</a></div><div class="ttdoc">An open-channel request out-message.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp_source.html#l00451">server_session_impl.hpp:452</a></div></div>
<div class="ttc" id="astructipc_1_1session_1_1Server__session__impl_1_1Open__channel__req_html_a522e6691e46f956648c64877b64d6219"><div class="ttname"><a href="structipc_1_1session_1_1Server__session__impl_1_1Open__channel__req.html#a522e6691e46f956648c64877b64d6219">ipc::session::Server_session_impl::Open_channel_req::m_req_msg</a></div><div class="ttdeci">Master_structured_channel::Msg_out m_req_msg</div><div class="ttdoc">See Client_session_impl::Master_channel_req::m_req_msg.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp_source.html#l00456">server_session_impl.hpp:456</a></div></div>
<div class="ttc" id="astructipc_1_1session_1_1Server__session__impl_1_1Open__channel__req_html_aa1a85c280c8144f3dfd4ba069de2eb0a"><div class="ttname"><a href="structipc_1_1session_1_1Server__session__impl_1_1Open__channel__req.html#aa1a85c280c8144f3dfd4ba069de2eb0a">ipc::session::Server_session_impl::Open_channel_req::m_mdt_builder</a></div><div class="ttdeci">Mdt_builder_ptr::element_type m_mdt_builder</div><div class="ttdoc">See Client_session_impl::Master_channel_req::m_mdt_builder.</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp_source.html#l00454">server_session_impl.hpp:454</a></div></div>
<div class="ttc" id="astructipc_1_1session_1_1Server__session__impl_1_1Open__channel__req_html_af46d9d419a695676703311def193044d"><div class="ttname"><a href="structipc_1_1session_1_1Server__session__impl_1_1Open__channel__req.html#af46d9d419a695676703311def193044d">ipc::session::Server_session_impl::Open_channel_req::m_opened_channel</a></div><div class="ttdeci">Channel_obj m_opened_channel</div><div class="ttdoc">The transport::Channel, including the needed shared resources acquired, from Server_session_impl::mdt...</div><div class="ttdef"><b>Definition:</b> <a href="ipc__session_2src_2ipc_2session_2detail_2server__session__impl_8hpp_source.html#l00464">server_session_impl.hpp:464</a></div></div>
<div class="ttc" id="astructipc_1_1util_1_1Native__handle_html"><div class="ttname"><a href="structipc_1_1util_1_1Native__handle.html">ipc::util::Native_handle</a></div><div class="ttdoc">A monolayer-thin wrapper around a native handle, a/k/a descriptor a/k/a FD.</div><div class="ttdef"><b>Definition:</b> <a href="native__handle_8hpp_source.html#l00062">native_handle.hpp:63</a></div></div>
</div><!-- fragment --></div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
Generated on Thu May 2 2024 23:56:38 for Flow-IPC by&#160;<a href="https://www.doxygen.org/index.html"><img class="footer" src="doxygen.svg" width="104" height="31" alt="doxygen"/></a> 1.9.4
</small></address>
</body>
</html>
